@idea1/cli 1.10.3 → 1.11.0

package/dist/services/platform.d.ts

@@ -6,30 +6,33 @@ import type { ClaudeRunOptions } from './claude.js';
  * The CLI's access to the Idea1 cloud platform (app.idea1.ai / api.idea1.ai): reading a project
  * item's summary (by item or by branch), recording the item's workflow context, setting its workflow
  * status (with the teammate it is assigned to), creating items, listing the team's Projects and
- * members, deriving a branch name from an item. Callers use `platform.someFunction()` and know
- * nothing about the transport.
+ * members, deriving a branch name from an item, and reading who is signed in. Callers use
+ * `platform.someFunction()` and know nothing about the transport.
  *
- * Today the transport is Claude Code driving the Idea1 MCP tools. That is an implementation detail
- * of this module - it may be replaced by authenticated calls to the platform's HTTP API without
- * touching any caller. Because these are simple tool calls rather than implementation sessions,
- * every Claude run here uses PLATFORM_CALL_RUN_OPTIONS. The prompts are the templates in
- * `src/prompts/platform-prompts.ts`; this module owns the output schemas their answers are read with.
+ * The transport is the platform's REST API, authorized with the user's OAuth credential or
+ * `IDEA1_TOKEN` (see `platform-auth.ts`), on the team that credential is bound to. Responses are the
+ * platform's `ApiDataResponse` envelope; a refused request surfaces as an Error carrying the
+ * platform's status and message. Claude is used only to name branches, on PLATFORM_CALL_RUN_OPTIONS.
  */
 /**
- * Model and effort for every platform call: a small, fast model at medium effort is all a
- * single MCP tool call needs, and pinning it keeps these calls consistent and cheap.
+ * Model and effort for the Claude run that names a branch: a small, fast model at medium effort is
+ * all a one-line answer from a description needs, and pinning it keeps the run consistent and cheap.
  */
 export declare const PLATFORM_CALL_RUN_OPTIONS: Required<ClaudeRunOptions>;
+/**
+ * Who the platform credential signs in as: the user's email address and the team its calls work on.
+ */
+export interface SignedInUser {
+    emailAddress: string;
+    teamName: string;
+}
 /**
  * Record workflow context updates on an idea1.ai project item directly, with no side effects on the
  * platform: the CLI has already run the transition's work locally. The item must be under workflow
  * management (have a workflow context); the workflow engine is the only caller, as the persist step
  * of a transition. `assignedToEmail` names the team member the item is assigned to along with the
- * status; null leaves the assignment as it is.
- *
- * TODO: Direct workflow-context updates move from the update_item MCP tool to an authenticated
- * platform API call; the CLI will authenticate a user and call the API for direct integrations
- * like this, and MCP tools will be only operations that agents should run.
+ * status; null leaves the assignment as it is. Returns false, with a warning, when the platform did
+ * not record it.
  */
 export declare function setWorkflowStatus(itemUrl: string, status: string, pullRequestUrl: string | null, assignedToEmail: string | null): Promise<boolean>;
 /**
@@ -67,7 +70,7 @@ export interface UpsertProjectItemWorkflowContextInput {
  */
 export declare function upsertProjectItemWorkflowContext(input: UpsertProjectItemWorkflowContextInput): Promise<ProjectItemSummary>;
 /**
- * Generate a branch name from a project item description
+ * Generate a branch name from a project item's description.
  */
 export declare function generateBranchName(itemUrl: string): Promise<string>;
 /**
@@ -86,9 +89,13 @@ export declare function listTeamMembers(): Promise<TeamMember[]>;
  */
 export declare function resolveTeammate(identity: string): Promise<TeamMember>;
 /**
- * Create a new idea1 project item with the given title in the named Project.
+ * Create a new idea1 project item with the given title in the named live Project.
  * The item is created with description `# <title>`.
  * Returns the created item's URL.
  */
 export declare function createProjectItem(title: string, projectName: string): Promise<string>;
+/**
+ * The user the platform credential signs in as, and the team its calls work on.
+ */
+export declare function getSignedInUser(): Promise<SignedInUser>;
 //# sourceMappingURL=platform.d.ts.map

package/dist/services/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/services/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAelE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,gBAAgB,CAAyC,CAAC;AAgB3G;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBxJ;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAclJ;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkBxF;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAsB,gCAAgC,CAAC,KAAK,EAAE,qCAAqC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkBhI;AAwED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAezE;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAUtD;AAoBD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvD;AAkBD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ3E;AA4BD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe3F"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/services/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,sCAAsC,CAAC;AAC7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAKlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,gBAAgB,CAAyC,CAAC;AA4D3G;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqID;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAaxJ;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CASlJ;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIxF;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAsB,gCAAgC,CAAC,KAAK,EAAE,qCAAqC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAehI;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWzE;AAUD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAItD;AAID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvD;AAcD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ3E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY3F;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAG7D"}

package/dist/services/platform.js

@@ -1,68 +1,182 @@
 import { logger } from '../lib/logger.js';
-import { AgentErrorResponse, validateAgentResponse } from '../lib/agent-core.js';
-import { isProjectItemUrl } from '../lib/project-item-url.js';
-import { createProjectItemPrompt, generateBranchNamePrompt, getProjectItemSummaryForBranchPrompt, getProjectItemSummaryPrompt, listProjectsPrompt, listTeamMembersPrompt, setWorkflowStatusPrompt, upsertProjectItemWorkflowContextPrompt } from '../prompts/platform-prompts.js';
+import { projectItemExternalId } from '../lib/project-item-url.js';
+import { generateBranchNamePrompt } from '../prompts/platform-prompts.js';
 import * as claude from './claude.js';
+import { apiBaseUrl, authorizedFetch } from './platform-auth.js';
 /**
  * The CLI's access to the Idea1 cloud platform (app.idea1.ai / api.idea1.ai): reading a project
  * item's summary (by item or by branch), recording the item's workflow context, setting its workflow
  * status (with the teammate it is assigned to), creating items, listing the team's Projects and
- * members, deriving a branch name from an item. Callers use `platform.someFunction()` and know
- * nothing about the transport.
+ * members, deriving a branch name from an item, and reading who is signed in. Callers use
+ * `platform.someFunction()` and know nothing about the transport.
  *
- * Today the transport is Claude Code driving the Idea1 MCP tools. That is an implementation detail
- * of this module - it may be replaced by authenticated calls to the platform's HTTP API without
- * touching any caller. Because these are simple tool calls rather than implementation sessions,
- * every Claude run here uses PLATFORM_CALL_RUN_OPTIONS. The prompts are the templates in
- * `src/prompts/platform-prompts.ts`; this module owns the output schemas their answers are read with.
+ * The transport is the platform's REST API, authorized with the user's OAuth credential or
+ * `IDEA1_TOKEN` (see `platform-auth.ts`), on the team that credential is bound to. Responses are the
+ * platform's `ApiDataResponse` envelope; a refused request surfaces as an Error carrying the
+ * platform's status and message. Claude is used only to name branches, on PLATFORM_CALL_RUN_OPTIONS.
  */
 /**
- * Model and effort for every platform call: a small, fast model at medium effort is all a
- * single MCP tool call needs, and pinning it keeps these calls consistent and cheap.
+ * Model and effort for the Claude run that names a branch: a small, fast model at medium effort is
+ * all a one-line answer from a description needs, and pinning it keeps the run consistent and cheap.
  */
 export const PLATFORM_CALL_RUN_OPTIONS = { model: 'sonnet', effort: 'medium' };
 /**
- * Run a platform call with a JSON schema, returning the parsed structured output.
+ * The platform's `ApiResultType`, the `result` of every response envelope.
  */
-async function callStructured(prompt, jsonSchema) {
-    return claude.runStructured(prompt, jsonSchema, PLATFORM_CALL_RUN_OPTIONS);
+var ApiResultType;
+(function (ApiResultType) {
+    ApiResultType[ApiResultType["Ok"] = 0] = "Ok";
+    ApiResultType[ApiResultType["Failed"] = 1] = "Failed";
+    ApiResultType[ApiResultType["NotFound"] = 2] = "NotFound";
+    ApiResultType[ApiResultType["Unauthorized"] = 3] = "Unauthorized";
+    ApiResultType[ApiResultType["InvalidRequest"] = 4] = "InvalidRequest";
+    ApiResultType[ApiResultType["QuotaLimit"] = 5] = "QuotaLimit";
+})(ApiResultType || (ApiResultType = {}));
+/**
+ * The platform's `ProjectStatus`.
+ */
+var ProjectStatus;
+(function (ProjectStatus) {
+    ProjectStatus[ProjectStatus["Live"] = 0] = "Live";
+    ProjectStatus[ProjectStatus["Completed"] = 1] = "Completed";
+    ProjectStatus[ProjectStatus["Cancelled"] = 2] = "Cancelled";
+})(ProjectStatus || (ProjectStatus = {}));
+/**
+ * Send a request to the platform's API, at `path` relative to the API base URL.
+ */
+function send(method, path, body) {
+    return authorizedFetch(`${apiBaseUrl()}/${path}`, {
+        method,
+        headers: body === null ? { Accept: 'application/json' } : { Accept: 'application/json', 'Content-Type': 'application/json' },
+        body: body === null ? undefined : JSON.stringify(body)
+    });
+}
+/**
+ * The `data` of a successful response; anything else throws an Error naming the request, the
+ * status and the platform's message.
+ */
+async function readData(method, path, response) {
+    const text = await response.text();
+    if (!response.ok) {
+        const message = serverMessage(text);
+        throw new Error(`idea1.ai refused ${method} /${path} (${response.status} ${response.statusText})${message.length > 0 ? `: ${message}` : ''}`);
+    }
+    const envelope = JSON.parse(text);
+    if (envelope.result !== ApiResultType.Ok) {
+        throw new Error(`idea1.ai could not complete ${method} /${path}: ${ApiResultType[envelope.result]}`);
+    }
+    return envelope.data;
+}
+async function call(method, path, body) {
+    return readData(method, path, await send(method, path, body));
+}
+/**
+ * A branch name the platform returned, checked before it reaches git: the CLI passes branch names
+ * to git as arguments, so a name that is not a plain ref (one starting with `-` would read as an
+ * option) is refused.
+ */
+const SAFE_BRANCH_NAME = /^(?!-)(?!.*\.\.)[A-Za-z0-9._\/-]+$/;
+function checkedBranchName(name) {
+    if (!SAFE_BRANCH_NAME.test(name)) {
+        throw new Error(`idea1.ai returned an invalid branch name: ${JSON.stringify(name)}`);
+    }
+    return name;
+}
+/**
+ * A project item URL the platform returned, checked before it is stored in git config: it must be a
+ * plain idea1.ai project item URL.
+ */
+const SAFE_PROJECT_ITEM_URL = /^https?:\/\/(app\.idea1\.ai|localhost(:\d+)?)\/project\/items\/\d+\/?$/i;
+function checkedProjectItemUrl(url) {
+    if (!SAFE_PROJECT_ITEM_URL.test(url)) {
+        throw new Error(`idea1.ai returned an invalid project item URL: ${JSON.stringify(url)}`);
+    }
+    return url;
+}
+/**
+ * A workflow context the platform returned, with its branch names checked. Each field is copied by
+ * name, so nothing the platform sent reaches git without passing the check.
+ */
+function checkedContext(context) {
+    return {
+        workflowStatus: context.workflowStatus,
+        codingAgentUrl: context.codingAgentUrl,
+        pullRequestUrl: context.pullRequestUrl,
+        repositoryFullName: context.repositoryFullName,
+        branchName: checkedBranchName(context.branchName),
+        baseBranch: checkedBranchName(context.baseBranch),
+        devWorkflowType: context.devWorkflowType,
+        stackBranch: context.stackBranch === null ? null : checkedBranchName(context.stackBranch),
+        integrationBranch: context.integrationBranch === null ? null : checkedBranchName(context.integrationBranch),
+        branchState: context.branchState
+    };
+}
+/** A project item summary the platform returned, with its URL and the branch names of its workflow context checked. */
+function checkedSummary(summary) {
+    return {
+        url: checkedProjectItemUrl(summary.url),
+        externalId: summary.externalId,
+        title: summary.title,
+        epicId: summary.epicId,
+        completionDate: summary.completionDate,
+        legacyWorkflowStatus: summary.legacyWorkflowStatus,
+        projectId: summary.projectId,
+        assignedToUserId: summary.assignedToUserId,
+        workflowContext: summary.workflowContext === null ? null : checkedContext(summary.workflowContext)
+    };
+}
+async function callForSummary(method, path, body) {
+    return checkedSummary(await call(method, path, body));
+}
+/**
+ * The message an error response carries: the `message` (or OAuth `error_description`) of a JSON
+ * body, a JSON string, or the body's text; empty for an empty body.
+ */
+function serverMessage(text) {
+    const trimmed = text.trim();
+    try {
+        const body = JSON.parse(trimmed);
+        if (typeof body === 'string') {
+            return body;
+        }
+        if (typeof body === 'object' && body !== null) {
+            const fields = body;
+            const message = [fields.message, fields.error_description, fields.error, fields.detail, fields.title].find(value => typeof value === 'string');
+            if (typeof message === 'string') {
+                return message;
+            }
+        }
+    }
+    catch {
+        // Not JSON: the text is the message.
+    }
+    return trimmed.slice(0, 500);
 }
 /**
- * Run a platform call whose answer is a single string; a model refusal throws AgentErrorResponse.
+ * The path of a project item by its URL's external id.
  */
-async function callForResult(prompt) {
-    return claude.runWithPrompt(prompt, PLATFORM_CALL_RUN_OPTIONS);
+function projectItemPath(itemUrl) {
+    return `v1/teams/active/project-items/by-external-id/${projectItemExternalId(itemUrl)}`;
 }
 /**
  * Record workflow context updates on an idea1.ai project item directly, with no side effects on the
  * platform: the CLI has already run the transition's work locally. The item must be under workflow
  * management (have a workflow context); the workflow engine is the only caller, as the persist step
  * of a transition. `assignedToEmail` names the team member the item is assigned to along with the
- * status; null leaves the assignment as it is.
- *
- * TODO: Direct workflow-context updates move from the update_item MCP tool to an authenticated
- * platform API call; the CLI will authenticate a user and call the API for direct integrations
- * like this, and MCP tools will be only operations that agents should run.
+ * status; null leaves the assignment as it is. Returns false, with a warning, when the platform did
+ * not record it.
  */
 export async function setWorkflowStatus(itemUrl, status, pullRequestUrl, assignedToEmail) {
-    const hasClaude = await claude.ensureClaudeCli();
-    if (!hasClaude) {
-        logger.warning('Claude CLI not available, skipping workflow status update');
-        return false;
-    }
     logger.step(assignedToEmail === null
         ? `Setting workflow status to "${status}"...`
         : `Setting workflow status to "${status}", assigned to ${assignedToEmail}...`);
     try {
-        await callForResult(setWorkflowStatusPrompt({ projectItemUrl: itemUrl, workflowStatus: status, pullRequestUrl, assignedToEmail }));
+        await call('PUT', `${projectItemPath(itemUrl)}/workflow-status`, { workflowStatus: status, pullRequestUrl, assignedToEmail });
         logger.success(`Workflow status updated to "${status}"`);
         return true;
     }
     catch (error) {
-        const message = error instanceof AgentErrorResponse
-            ? `Model could not update workflow status: ${error.message}`
-            : `Could not update workflow status: ${error.message}`;
-        logger.warning(message);
+        logger.warning(`Could not update workflow status: ${error.message}`);
         return false;
     }
 }
@@ -71,30 +185,21 @@ export async function setWorkflowStatus(itemUrl, status, pullRequestUrl, assigne
  * management. The repository is always named; nothing defaults it.
  */
 export async function getProjectItemSummaryForBranch(query) {
-    const hasClaude = await claude.ensureClaudeCli();
-    if (!hasClaude) {
-        throw new Error('Claude CLI is required to read the project item of a branch from idea1.ai');
-    }
     logger.step(`Reading the project item of ${query.branchName} from idea1.ai...`);
-    const output = await callStructured(getProjectItemSummaryForBranchPrompt(query), projectItemSummaryOutputSchema);
-    return readProjectItemSummaryOutput(output, error => /not under workflow management/i.test(error));
+    const path = `v1/teams/active/project-items/for-branch?${new URLSearchParams(query).toString()}`;
+    const response = await send('GET', path, null);
+    if (response.status === 404) {
+        return null;
+    }
+    return checkedSummary(await readData('GET', path, response));
 }
 /**
  * The summary of a project item: its `workflowContext` is null while the item is outside workflow
  * management.
  */
 export async function getProjectItemSummary(itemUrl) {
-    const hasClaude = await claude.ensureClaudeCli();
-    if (!hasClaude) {
-        throw new Error('Claude CLI is required to read a project item from idea1.ai');
-    }
     logger.step(`Reading ${itemUrl} from idea1.ai...`);
-    const output = await callStructured(getProjectItemSummaryPrompt({ projectItemUrl: itemUrl }), projectItemSummaryOutputSchema);
-    const summary = readProjectItemSummaryOutput(output, () => false);
-    if (!summary) {
-        throw new Error(`idea1.ai returned no project item for ${itemUrl}`);
-    }
-    return summary;
+    return callForSummary('GET', `${projectItemPath(itemUrl)}/summary`, null);
 }
 /**
  * Record a branch in a project item's workflow context as the one implementing the item, putting
@@ -104,120 +209,46 @@ export async function getProjectItemSummary(itemUrl) {
  * refused by the platform, which surfaces here as an error.
  */
 export async function upsertProjectItemWorkflowContext(input) {
-    const hasClaude = await claude.ensureClaudeCli();
-    if (!hasClaude) {
-        throw new Error('Claude CLI is required to record the workflow context on idea1.ai');
-    }
     logger.step(`Recording ${input.branchName} as the branch of ${input.projectItemUrl} on idea1.ai...`);
-    const output = await callStructured(upsertProjectItemWorkflowContextPrompt(input), projectItemSummaryOutputSchema);
-    const summary = readProjectItemSummaryOutput(output, () => false);
-    if (!summary?.workflowContext) {
+    const summary = await callForSummary('PUT', `${projectItemPath(input.projectItemUrl)}/workflow-context`, {
+        repositoryFullName: input.repositoryFullName,
+        branchName: input.branchName,
+        baseBranch: input.baseBranch,
+        devWorkflowType: input.devWorkflowType,
+        stackBranch: input.stackBranch,
+        integrationBranch: input.integrationBranch
+    });
+    if (summary.workflowContext === null) {
         throw new Error('The platform returned no workflow context after recording the branch');
     }
     return summary;
 }
 /**
- * The summary an output carries. An error `isAbsence` recognizes as "the platform has no such
- * item" yields null; any other error is thrown.
- */
-function readProjectItemSummaryOutput(output, isAbsence) {
-    if (typeof output.error === 'string' && output.error.trim().length > 0) {
-        if (isAbsence(output.error)) {
-            return null;
-        }
-        throw new Error(`idea1.ai: ${output.error.trim()}`);
-    }
-    const summary = output.projectItemSummary;
-    if (!summary || typeof summary.url !== 'string' || !isProjectItemUrl(summary.url)) {
-        throw new Error(`Claude did not return a valid project item summary: ${JSON.stringify(output.projectItemSummary)}`);
-    }
-    return summary;
-}
-/**
- * JSON schema for the project-item-summary structured output (`ProjectItemSummary` or an error).
- */
-const projectItemSummaryOutputSchema = {
-    type: 'object',
-    properties: {
-        projectItemSummary: {
-            type: ['object', 'null'],
-            description: 'The project item summary the tool returned, or null when it returned an error',
-            properties: {
-                url: { type: 'string' },
-                externalId: { type: 'integer' },
-                title: { type: 'string' },
-                epicId: { type: ['string', 'null'] },
-                completionDate: { type: ['string', 'null'] },
-                legacyWorkflowStatus: { type: 'string' },
-                projectId: { type: ['string', 'null'], description: 'The Project the item is planned in; null when it is out of scope' },
-                assignedToUserId: { type: ['string', 'null'], description: 'The team member the item is assigned to; null when unassigned' },
-                workflowContext: {
-                    type: ['object', 'null'],
-                    properties: {
-                        workflowStatus: { type: 'string' },
-                        codingAgentUrl: { type: 'string' },
-                        pullRequestUrl: { type: 'string' },
-                        repositoryFullName: { type: 'string' },
-                        branchName: { type: 'string' },
-                        baseBranch: { type: 'string' },
-                        devWorkflowType: { type: 'string', enum: ['independent', 'integration'] },
-                        stackBranch: { type: ['string', 'null'] },
-                        integrationBranch: { type: ['string', 'null'] },
-                        branchState: { type: 'integer', enum: [0, 1, 2], description: '0 Live, 1 Merged, 2 Deleted' }
-                    },
-                    required: ['workflowStatus', 'codingAgentUrl', 'pullRequestUrl', 'repositoryFullName', 'branchName', 'baseBranch', 'devWorkflowType', 'stackBranch', 'integrationBranch', 'branchState'],
-                    additionalProperties: false
-                }
-            },
-            required: ['url', 'externalId', 'title', 'epicId', 'completionDate', 'legacyWorkflowStatus', 'projectId', 'assignedToUserId', 'workflowContext'],
-            additionalProperties: false
-        },
-        error: { type: ['string', 'null'], description: 'The error the tool returned, verbatim, or null on success' }
-    },
-    required: ['projectItemSummary', 'error'],
-    additionalProperties: false
-};
-/**
- * Generate a branch name from a project item description
+ * Generate a branch name from a project item's description.
  */
 export async function generateBranchName(itemUrl) {
-    const hasClaude = await claude.ensureClaudeCli();
-    if (!hasClaude) {
-        throw new Error('Claude CLI is required to generate branch names');
-    }
     logger.step('Generating branch name from item description...');
-    const branchName = await callForResult(generateBranchNamePrompt({ projectItemUrl: itemUrl }));
+    const item = await call('GET', projectItemPath(itemUrl), null);
+    const branchName = await claude.runWithPrompt(generateBranchNamePrompt({ description: item.description }), PLATFORM_CALL_RUN_OPTIONS);
     // Clean up any extra whitespace/newlines
     const cleanedName = branchName.replace(/\n/g, '').trim();
     logger.dim(`Generated branch name: ${cleanedName}`);
     return cleanedName;
 }
+/**
+ * The team's live Projects, most recently created first.
+ */
+async function readLiveProjects() {
+    const projects = await call('GET', 'v1/teams/active/projects', null);
+    return projects.filter(project => project.status === ProjectStatus.Live);
+}
 /**
  * The names of the team's live Projects, most recently created first.
  */
 export async function listProjects() {
     logger.step('Reading the team\'s projects from idea1.ai...');
-    const output = await callStructured(listProjectsPrompt({}), listProjectsSchema);
-    const projects = Array.isArray(output.projects)
-        ? output.projects.filter((name) => typeof name === 'string' && name.trim().length > 0).map(name => name.trim())
-        : [];
-    return projects;
+    return (await readLiveProjects()).map(project => project.name);
 }
-/**
- * JSON schema for the list-projects structured output.
- */
-const listProjectsSchema = {
-    type: 'object',
-    properties: {
-        projects: {
-            type: 'array',
-            description: 'The names of the live Idea1 projects, most recently created first',
-            items: { type: 'string' }
-        }
-    },
-    required: ['projects'],
-    additionalProperties: false
-};
 let teamMembers = null;
 /**
  * The members of the team, read once per process: the teammates a project item can be assigned
@@ -234,11 +265,8 @@ export function listTeamMembers() {
 }
 async function readTeamMembers() {
     logger.step('Reading the team\'s members from idea1.ai...');
-    const output = await callStructured(listTeamMembersPrompt({}), listTeamMembersSchema);
-    if (!Array.isArray(output.members)) {
-        throw new Error(`Claude did not return the team's members: ${JSON.stringify(output.members)}`);
-    }
-    return output.members.map(member => ({
+    const members = await call('GET', 'v1/teams/active/members', null);
+    return members.map(member => ({
         userId: member.userId,
         email: member.email.trim(),
         role: member.role,
@@ -260,55 +288,25 @@ export async function resolveTeammate(identity) {
     return teammate;
 }
 /**
- * JSON schema for the list-team-members structured output.
- */
-const listTeamMembersSchema = {
-    type: 'object',
-    properties: {
-        members: {
-            type: 'array',
-            description: 'The team\'s members, in the order returned',
-            items: {
-                type: 'object',
-                properties: {
-                    userId: { type: 'string' },
-                    email: { type: 'string' },
-                    role: { type: 'string' },
-                    gitHubUsername: { type: ['string', 'null'], description: 'The member\'s linked GitHub login, or null when none is linked' }
-                },
-                required: ['userId', 'email', 'role', 'gitHubUsername'],
-                additionalProperties: false
-            }
-        }
-    },
-    required: ['members'],
-    additionalProperties: false
-};
-/**
- * Create a new idea1 project item with the given title in the named Project.
+ * Create a new idea1 project item with the given title in the named live Project.
  * The item is created with description `# <title>`.
  * Returns the created item's URL.
  */
 export async function createProjectItem(title, projectName) {
     logger.step(`Creating project item "${title}" in project "${projectName}"...`);
-    const output = validateAgentResponse(await callStructured(createProjectItemPrompt({ title, projectName }), createProjectItemSchema));
-    const url = typeof output.projectItemUrl === 'string' ? output.projectItemUrl.trim() : '';
-    if (!isProjectItemUrl(url)) {
-        throw new Error(`Claude did not return a valid project item URL: ${JSON.stringify(output.projectItemUrl)}`);
+    const project = (await readLiveProjects()).find(candidate => candidate.name.trim().toLowerCase() === projectName.trim().toLowerCase());
+    if (!project) {
+        throw new Error(`The team has no live project named "${projectName}".`);
     }
-    logger.success(`Created project item: ${url}`);
-    return url;
+    const summary = await callForSummary('POST', `v1/teams/active/projects/${project.projectId}/project-items`, { description: `# ${title}` });
+    logger.success(`Created project item: ${summary.url}`);
+    return summary.url;
 }
 /**
- * JSON schema for the create-project-item structured output.
+ * The user the platform credential signs in as, and the team its calls work on.
  */
-const createProjectItemSchema = {
-    type: 'object',
-    properties: {
-        projectItemUrl: { type: 'string', description: 'The URL of the created idea1 project item, or an empty string on failure' },
-        error: { type: ['string', 'null'], description: 'The error returned by create_item, or null when the item was created' }
-    },
-    required: ['projectItemUrl', 'error'],
-    additionalProperties: false
-};
+export async function getSignedInUser() {
+    const context = await call('GET', 'v1/user/core-application-context', null);
+    return { emailAddress: context.userContext.emailAddress, teamName: context.activeTeam.teamName };
+}
 //# sourceMappingURL=platform.js.map