Check Prior Status

Instructions

Implementation Reference

• src/tools.ts:397-411 (handler)

  The handler function for the 'prior_status' tool. Calls client.getStatus() and returns structured content with id, authType, credits, tier, contributions, displayName, and email.

  }, async () => {
    const status = await client.getStatus();
    return {
      structuredContent: {
        id: status.id,
        authType: status.authType,
        credits: status.credits,
        tier: status.tier,
        contributions: status.contributions,
        displayName: status.displayName,
        email: status.email,
      },
      content: [{ type: "text" as const, text: formatResults(status) }],
    };
  });

• src/client.ts:603-651 (handler)

  The getStatus() method on PriorApiClient that fetches status data from the API. For OIDC auth, calls /v1/account, /v1/prior/me/profile, and fetchUserInfo. For API key auth, calls /v1/agents/me.

  async getStatus(): Promise<PriorStatus> {
    const auth = await this.ensureAuth();
  
    if (this._authType === "oidc") {
      const [accountEnvelope, profileEnvelope, userinfo] = await Promise.all([
        this.request("GET", "/v1/account", undefined, auth),
        this.request("GET", "/v1/prior/me/profile", undefined, auth),
        this.fetchUserInfo(auth),
      ]);
      const account = extractData<any>(accountEnvelope);
      const profile = extractData<any>(profileEnvelope);
      const displayName = userinfo.name || this._displayName;
      const email = userinfo.email || this._email;
  
      this._accountId = userinfo.sub || account?.account?.id || this._accountId;
      this._displayName = displayName;
      this._email = email;
      this.persistCurrentConfig({
        authType: "oidc",
        accessToken: this._accessToken,
        refreshToken: this._refreshToken,
        expiresAt: this._expiresAt,
        accountId: this._accountId,
        displayName: this._displayName,
        email: this._email,
      });
  
      return {
        id: account?.account?.id || userinfo.sub || "",
        authType: "oidc",
        credits: Number(profile?.subscription?.credits ?? 0),
        tier: profile?.subscription?.tier || "free",
        contributions: profile?.reputation?.contributionCount,
        displayName,
        email,
      };
    }
  
    const data = await this.request("GET", "/v1/agents/me", undefined, auth);
    const agent = extractData<any>(data);
    return {
      id: agent?.id || "",
      authType: "api_key",
      credits: agent?.credits ?? 0,
      tier: agent?.tier || "free",
      contributions: agent?.contributions,
      displayName: agent?.agentName,
    };
  }

• src/client.ts:37-45 (schema)

  The PriorStatus interface defining the shape of the status response (id, authType, credits, tier, contributions, displayName, email).

  export interface PriorStatus {
    id: string;
    authType: PriorAuthType;
    credits: number;
    tier: string;
    contributions?: number;
    displayName?: string;
    email?: string;
  }

• src/tools.ts:384-397 (registration)

  Registration of the 'prior_status' tool via server.registerTool with title, description, annotations, and output schema.

  server.registerTool("prior_status", {
    title: "Check Prior Status",
    description: "Check your current Prior auth mode, credits, tier, and contribution count. Also available as a resource at prior://agent/status.",
    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
    outputSchema: {
      id: z.string(),
      authType: z.string(),
      credits: z.number().describe("Current credit balance"),
      tier: z.string(),
      contributions: z.number().optional(),
      displayName: z.string().optional(),
      email: z.string().optional(),
    },
  }, async () => {

• src/tools.ts:59-75 (helper)

  Helper function expandNudgeTokens that replaces [PRIOR:STATUS] token with `prior_status()` call syntax in message templates.

  export function expandNudgeTokens(message: string): string {
    return message
      // Parameterized feedback with entry ID (Phase 1) - must come BEFORE generic patterns
      .replace(/\[PRIOR:FEEDBACK:useful:([^\]]+)\]/g, (_m, id) => `\`prior_feedback(entryId: "${id}", outcome: "useful")\``)
      .replace(/\[PRIOR:FEEDBACK:not_useful:([^\]]+)\]/g, (_m, id) => `\`prior_feedback(entryId: "${id}", outcome: "not_useful", reason: "describe what you tried")\``)
      .replace(/\[PRIOR:FEEDBACK:irrelevant:([^\]]+)\]/g, (_m, id) => `\`prior_feedback(entryId: "${id}", outcome: "irrelevant")\``)
      // Generic (non-parameterized) - fallback for templates without IDs
      .replace(/\[PRIOR:CONTRIBUTE\]/g, '`prior_contribute(...)`')
      .replace(/\[PRIOR:FEEDBACK:useful\]/g, '`prior_feedback(entryId: "...", outcome: "useful")`')
      .replace(/\[PRIOR:FEEDBACK:not_useful\]/g, '`prior_feedback(entryId: "...", outcome: "not_useful", reason: "...")`')
      .replace(/\[PRIOR:FEEDBACK:irrelevant\]/g, '`prior_feedback(entryId: "...", outcome: "irrelevant")`')
      .replace(/\[PRIOR:FEEDBACK\]/g, '`prior_feedback(...)`')
      .replace(/\[PRIOR:STATUS\]/g, '`prior_status()`')
      .replace(/\[PRIOR:CONTRIBUTE ([^\]]+)\]/g, (_match, attrs) => {
        return `\`prior_contribute(${attrs})\``;
      });
  }