@shakecodeslikecray/npc-cli 0.1.0

package/README.md

@@ -0,0 +1,60 @@
+# NPC CLI
+
+MCP server + CLI for the NPC project orchestration system.
+
+## Setup
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Auth
+npc auth login -e user@example.com -p password
+npc auth status
+npc auth logout
+
+# Projects
+npc project create -n "My Project" -i MP
+npc project list
+npc project stats
+
+# Tasks
+npc tasks
+npc pull
+npc start <task-id>
+npc complete <task-id> -s "Done"
+npc block <task-id> -r "Waiting on API"
+npc signal <task-id> -c quality -t tests_passed -v '{"passed":true}'
+
+# Context
+npc context <module-id>
+
+# Bulk operations
+npc items bulk-create <project-id> items.json
+npc edge create --project <id> --from <id> --to <id>
+```
+
+### MCP Server
+
+```bash
+npc mcp
+```
+
+Add to Claude Code config:
+
+```json
+{
+  "mcpServers": {
+    "npc": {
+      "command": "node",
+      "args": ["/path/to/npc-cli/dist/mcp.js"]
+    }
+  }
+}
+```

package/dist/adapters/claude-code.d.ts

@@ -0,0 +1,21 @@
+export interface ParsedTelemetry {
+    session_id?: string;
+    model?: string;
+    tokens_in: number;
+    tokens_out: number;
+    cache_read_tokens: number;
+    cache_creation_tokens: number;
+    cost_usd: number;
+    duration_ms: number;
+    num_turns: number;
+    tool_calls: number;
+    tool_failures: number;
+    metadata: {
+        tool_breakdown: Record<string, number>;
+        errors: string[];
+        stop_reason?: string;
+    };
+    work_item_id?: string;
+}
+export declare function parseClaudeCodeTranscript(transcriptPath: string): ParsedTelemetry;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,CAwFjF"}

package/dist/adapters/claude-code.js

@@ -0,0 +1,83 @@
+import { readFileSync } from "fs";
+export function parseClaudeCodeTranscript(transcriptPath) {
+    const content = readFileSync(transcriptPath, "utf-8");
+    const lines = content.split("\n").filter(Boolean);
+    const result = {
+        tokens_in: 0,
+        tokens_out: 0,
+        cache_read_tokens: 0,
+        cache_creation_tokens: 0,
+        cost_usd: 0,
+        duration_ms: 0,
+        num_turns: 0,
+        tool_calls: 0,
+        tool_failures: 0,
+        metadata: { tool_breakdown: {}, errors: [] },
+    };
+    let firstTimestamp;
+    let lastTimestamp;
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            // Track timestamps for duration
+            if (entry.timestamp) {
+                const ts = new Date(entry.timestamp).getTime();
+                if (!firstTimestamp)
+                    firstTimestamp = ts;
+                lastTimestamp = ts;
+            }
+            // Session ID
+            if (entry.type === "system" && entry.subtype === "init" && entry.session_id) {
+                result.session_id = entry.session_id;
+            }
+            // API request events (token usage)
+            if (entry.type === "assistant" && entry.message?.usage) {
+                const u = entry.message.usage;
+                result.tokens_in += u.input_tokens ?? 0;
+                result.tokens_out += u.output_tokens ?? 0;
+                result.cache_read_tokens += u.cache_read_input_tokens ?? 0;
+                result.cache_creation_tokens += u.cache_creation_input_tokens ?? 0;
+                result.num_turns++;
+                if (entry.message.model)
+                    result.model = entry.message.model;
+            }
+            // Tool use tracking
+            if (entry.type === "assistant" && entry.message?.content) {
+                for (const block of entry.message.content) {
+                    if (block.type === "tool_use") {
+                        result.tool_calls++;
+                        const name = block.name ?? "unknown";
+                        result.metadata.tool_breakdown[name] = (result.metadata.tool_breakdown[name] ?? 0) + 1;
+                        // Check for npc_pull_task or npc_start_task to find work item
+                        if ((name === "npc_pull_task" || name === "npc_start_task") && block.input?.task_id) {
+                            result.work_item_id = block.input.task_id;
+                        }
+                    }
+                }
+            }
+            // Tool results (check for errors)
+            if (entry.type === "tool_result" && entry.is_error) {
+                result.tool_failures++;
+                if (entry.content) {
+                    const errText = typeof entry.content === "string" ? entry.content : JSON.stringify(entry.content);
+                    result.metadata.errors.push(errText.slice(0, 200));
+                }
+            }
+            // Stop reason
+            if (entry.type === "result" && entry.stop_reason) {
+                result.metadata.stop_reason = entry.stop_reason;
+                if (entry.total_cost_usd)
+                    result.cost_usd = entry.total_cost_usd;
+            }
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    // Calculate duration from timestamps
+    if (firstTimestamp && lastTimestamp) {
+        result.duration_ms = lastTimestamp - firstTimestamp;
+    }
+    return result;
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"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"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tool adapter registry.
+ *
+ * Each adapter knows how to:
+ * - locate the tool's MCP config file
+ * - read/write the mcpServers entry
+ * - parse session transcripts for telemetry
+ *
+ * Adding support for a new tool (e.g. Cursor, Windsurf) means adding an entry
+ * here that satisfies ToolAdapter and wiring it into TOOL_ADAPTERS.
+ */
+export interface McpEntry {
+    type: "stdio";
+    command: string;
+    args: string[];
+}
+export interface ToolAdapter {
+    /** Human-readable display name */
+    displayName: string;
+    /** Identifier used in --tool flags and agent_tool telemetry field */
+    toolId: string;
+    /** Absolute path to the JSON config file that holds mcpServers */
+    configPath: string;
+    /** Key inside the config that holds the mcpServers map */
+    mcpServersKey: string;
+    /** Short restart instruction shown after install */
+    restartHint: string;
+}
+export declare const TOOL_ADAPTERS: Record<string, ToolAdapter>;
+/** Default tool ID used when --tool is not specified. */
+export declare const DEFAULT_TOOL_ID = "claude_code";
+/** @deprecated Use DEFAULT_TOOL_ID */
+export declare const DEFAULT_TOOL = "claude_code";
+export declare function getAdapter(toolId: string): ToolAdapter | undefined;
+export declare function listSupportedTools(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyBrD,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,sCAAsC;AACtC,eAAO,MAAM,YAAY,gBAAkB,CAAC;AAE5C,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElE;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/adapters/index.js

@@ -0,0 +1,50 @@
+/**
+ * Tool adapter registry.
+ *
+ * Each adapter knows how to:
+ * - locate the tool's MCP config file
+ * - read/write the mcpServers entry
+ * - parse session transcripts for telemetry
+ *
+ * Adding support for a new tool (e.g. Cursor, Windsurf) means adding an entry
+ * here that satisfies ToolAdapter and wiring it into TOOL_ADAPTERS.
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+export const TOOL_ADAPTERS = {
+    claude_code: {
+        displayName: "Claude Code",
+        toolId: "claude_code",
+        configPath: join(homedir(), ".claude.json"),
+        mcpServersKey: "mcpServers",
+        restartHint: "Restart Claude Code to activate.",
+    },
+    // Cursor: stores MCP config in ~/.cursor/mcp.json under "mcpServers"
+    // Uncomment when Cursor MCP support ships:
+    // cursor: {
+    //   displayName: "Cursor",
+    //   toolId: "cursor",
+    //   configPath: join(homedir(), ".cursor", "mcp.json"),
+    //   mcpServersKey: "mcpServers",
+    //   restartHint: "Restart Cursor to activate.",
+    // },
+    // Windsurf: stores MCP config in ~/.codeium/windsurf/mcp_config.json
+    // windsurf: {
+    //   displayName: "Windsurf",
+    //   toolId: "windsurf",
+    //   configPath: join(homedir(), ".codeium", "windsurf", "mcp_config.json"),
+    //   mcpServersKey: "mcpServers",
+    //   restartHint: "Restart Windsurf to activate.",
+    // },
+};
+/** Default tool ID used when --tool is not specified. */
+export const DEFAULT_TOOL_ID = "claude_code";
+/** @deprecated Use DEFAULT_TOOL_ID */
+export const DEFAULT_TOOL = DEFAULT_TOOL_ID;
+export function getAdapter(toolId) {
+    return TOOL_ADAPTERS[toolId];
+}
+export function listSupportedTools() {
+    return Object.keys(TOOL_ADAPTERS);
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,WAAW,EAAE;QACX,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC;QAC3C,aAAa,EAAE,YAAY;QAC3B,WAAW,EAAE,kCAAkC;KAChD;IACD,qEAAqE;IACrE,2CAA2C;IAC3C,YAAY;IACZ,2BAA2B;IAC3B,sBAAsB;IACtB,wDAAwD;IACxD,iCAAiC;IACjC,gDAAgD;IAChD,KAAK;IACL,qEAAqE;IACrE,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,4EAA4E;IAC5E,iCAAiC;IACjC,kDAAkD;IAClD,KAAK;CACN,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C,sCAAsC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAE5C,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC"}

package/dist/client/api.d.ts

@@ -0,0 +1,50 @@
+import type { Project, Repo, CreateProjectInput, CreateRepoInput, WorkItem, WorkItemEdge, CreateEdgeInput, Signal, CreateSignalInput, BulkCreateItem, CompleteInput, BlockInput, RepoStats, ProjectStats, QueueNextResponse, WorkItemContext, SignalHealthSummary, ScheduleResult, AIModel, WorkItemReference, CreateReferenceInput, Document, TelemetryEvent, CreateTelemetryInput } from "../types.js";
+/** Reset client (useful after login when token changes). */
+export declare function resetClient(): void;
+export declare function createProject(data: CreateProjectInput): Promise<Project>;
+export declare function getProject(id: string): Promise<Project>;
+export declare function listProjects(): Promise<Project[]>;
+export declare function getProjectStats(): Promise<Record<string, ProjectStats>>;
+export declare function getProjectRepos(projectId: string): Promise<Repo[]>;
+export declare function getProjectDashboard(projectId: string): Promise<unknown>;
+export declare function createRepo(data: CreateRepoInput): Promise<Repo>;
+export declare function getRepo(id: string): Promise<Repo>;
+export declare function listRepos(): Promise<Repo[]>;
+export declare function getRepoStats(): Promise<Record<string, RepoStats>>;
+export declare function getWorkItems(repoId: string, params?: Record<string, string>): Promise<WorkItem[]>;
+export declare function getWorkItem(repoId: string, itemId: string): Promise<WorkItem>;
+export declare function bulkCreateWorkItems(repoId: string, items: BulkCreateItem[]): Promise<WorkItem[]>;
+export declare function getWorkItemDescendants(repoId: string, itemId: string): Promise<WorkItem[]>;
+export declare function getWorkItemChildren(repoId: string, itemId: string): Promise<WorkItem[]>;
+export declare function transitionWorkItem(itemId: string, state: string): Promise<WorkItem>;
+export declare function startWorkItem(itemId: string): Promise<WorkItem>;
+export declare function completeWorkItem(itemId: string, data: CompleteInput): Promise<WorkItem>;
+export declare function blockWorkItem(itemId: string, data: BlockInput): Promise<WorkItem>;
+export declare function getMyTasks(): Promise<WorkItem[]>;
+export declare function getWorkItemContext(itemId: string): Promise<WorkItemContext>;
+export declare function queueNext(repoId?: string): Promise<QueueNextResponse>;
+export declare function myTasksNext(repoId?: string): Promise<QueueNextResponse>;
+export declare function createEdge(repoId: string, data: CreateEdgeInput): Promise<WorkItemEdge>;
+export declare function listEdges(repoId: string): Promise<WorkItemEdge[]>;
+export declare function scheduleProject(projectId: string, startDate: string): Promise<ScheduleResult>;
+export declare function createSignal(workItemId: string, signal: CreateSignalInput): Promise<Signal>;
+export declare function listSignals(workItemId: string): Promise<Signal[]>;
+export declare function getSignalHealth(workItemId: string): Promise<SignalHealthSummary>;
+export declare function listAIModels(): Promise<AIModel[]>;
+export declare function listAvailableModels(): Promise<AIModel[]>;
+export declare function listModelsByTier(tier: number): Promise<AIModel[]>;
+export declare function getMyModels(): Promise<AIModel[]>;
+export declare function setMyModels(modelIds: string[]): Promise<void>;
+export declare function listUsers(role?: string): Promise<unknown[]>;
+export declare function listReferences(workItemId: string, inherited?: boolean): Promise<WorkItemReference[]>;
+export declare function createReference(workItemId: string, data: CreateReferenceInput): Promise<WorkItemReference>;
+export declare function deleteReference(workItemId: string, refId: string): Promise<void>;
+export declare function listDocuments(repoId: string): Promise<Document[]>;
+export declare function uploadDocument(repoId: string, filename: string, content: Buffer, contentType?: string): Promise<Document>;
+export declare function getDocument(repoId: string, docId: string): Promise<Document>;
+export declare function getDocumentContent(repoId: string, docId: string): Promise<string>;
+export declare function deleteDocument(repoId: string, docId: string): Promise<void>;
+export declare function createTelemetry(workItemId: string, input: CreateTelemetryInput): Promise<TelemetryEvent>;
+export declare const reportTelemetry: typeof createTelemetry;
+export declare function listTelemetry(workItemId: string): Promise<TelemetryEvent[]>;
+//# sourceMappingURL=api.d.ts.map

package/dist/client/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/client/api.ts"],"names":[],"mappings":"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"}

package/dist/client/api.js

@@ -0,0 +1,325 @@
+import axios from "axios";
+import FormData from "form-data";
+import { getToken, getApiUrl, getApiKey, isTokenExpired, refreshToken } from "./auth.js";
+let _refreshing = null;
+function createClient() {
+    const client = axios.create({
+        baseURL: getApiUrl(),
+        timeout: 30_000,
+        headers: { "Content-Type": "application/json" },
+    });
+    // Pre-flight: if token is expired, try refresh before sending the request
+    client.interceptors.request.use(async (config) => {
+        try {
+            if (isTokenExpired()) {
+                if (!_refreshing)
+                    _refreshing = refreshToken();
+                const newToken = await _refreshing;
+                _refreshing = null;
+                if (newToken) {
+                    config.headers.Authorization = `Bearer ${newToken}`;
+                    return config;
+                }
+            }
+            const token = getToken();
+            config.headers.Authorization = `Bearer ${token}`;
+            // Only send agent key for queue and agent-exclusive work-item endpoints.
+            // Signal, comment, transition, and other role-based endpoints must NOT receive
+            // the agent key — it bypasses user role checks.
+            const agentSuffixes = ["/start", "/complete", "/block", "/heartbeat", "/escalate"];
+            const url = config.url ?? "";
+            const isQueueEndpoint = url.includes("/api/v1/queue/");
+            const isAgentWorkItem = url.includes("/api/v1/work-items/") &&
+                agentSuffixes.some((s) => url.endsWith(s));
+            const apiKey = getApiKey();
+            if (apiKey && (isQueueEndpoint || isAgentWorkItem))
+                config.headers["x-api-key"] = apiKey;
+        }
+        catch {
+            // Allow unauthenticated requests (login, etc.)
+        }
+        return config;
+    });
+    // Retry on 401: attempt refresh once, then replay the failed request
+    client.interceptors.response.use((res) => res, async (err) => {
+        const originalRequest = err.config;
+        if (err.response?.status === 401 &&
+            originalRequest &&
+            !originalRequest._retried) {
+            originalRequest._retried = true;
+            if (!_refreshing)
+                _refreshing = refreshToken();
+            let newToken = null;
+            try {
+                newToken = await _refreshing;
+            }
+            finally {
+                _refreshing = null;
+            }
+            if (newToken) {
+                originalRequest.headers.Authorization = `Bearer ${newToken}`;
+                return client(originalRequest);
+            }
+        }
+        const msg = err.response?.data?.error ?? err.message;
+        const status = err.response?.status ?? 0;
+        throw new Error(`API error (${status}): ${msg}`);
+    });
+    return client;
+}
+// Lazy singleton
+let _client = null;
+function client() {
+    if (!_client)
+        _client = createClient();
+    return _client;
+}
+/** Reset client (useful after login when token changes). */
+export function resetClient() {
+    _client = null;
+}
+// ---------------------------------------------------------------------------
+// Projects (group-level)
+// ---------------------------------------------------------------------------
+export async function createProject(data) {
+    const res = await client().post("/api/v1/projects/", data);
+    return res.data;
+}
+export async function getProject(id) {
+    const res = await client().get(`/api/v1/projects/${id}`);
+    return res.data;
+}
+export async function listProjects() {
+    const res = await client().get("/api/v1/projects/");
+    return res.data;
+}
+export async function getProjectStats() {
+    const res = await client().get("/api/v1/projects/stats");
+    return res.data;
+}
+export async function getProjectRepos(projectId) {
+    const res = await client().get(`/api/v1/projects/${projectId}/repos`);
+    return res.data;
+}
+export async function getProjectDashboard(projectId) {
+    const res = await client().get(`/api/v1/projects/${projectId}/dashboard`);
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Repos (individual codebases, formerly "projects")
+// ---------------------------------------------------------------------------
+export async function createRepo(data) {
+    const res = await client().post("/api/v1/repos/", data);
+    return res.data;
+}
+export async function getRepo(id) {
+    const res = await client().get(`/api/v1/repos/${id}`);
+    return res.data;
+}
+export async function listRepos() {
+    const res = await client().get("/api/v1/repos/");
+    return res.data;
+}
+export async function getRepoStats() {
+    const res = await client().get("/api/v1/repos/stats");
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Work Items
+// ---------------------------------------------------------------------------
+export async function getWorkItems(repoId, params) {
+    const res = await client().get(`/api/v1/repos/${repoId}/work-items/`, { params });
+    return res.data;
+}
+export async function getWorkItem(repoId, itemId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/work-items/${itemId}`);
+    return res.data;
+}
+export async function bulkCreateWorkItems(repoId, items) {
+    const res = await client().post(`/api/v1/repos/${repoId}/work-items/bulk`, items);
+    return res.data;
+}
+export async function getWorkItemDescendants(repoId, itemId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/work-items/${itemId}/descendants`);
+    return res.data;
+}
+export async function getWorkItemChildren(repoId, itemId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/work-items/${itemId}/children`);
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Work Item Transitions (cross-repo endpoints at /api/v1/work-items/...)
+// ---------------------------------------------------------------------------
+export async function transitionWorkItem(itemId, state) {
+    const res = await client().post(`/api/v1/work-items/${itemId}/transition`, { state });
+    return res.data;
+}
+export async function startWorkItem(itemId) {
+    const res = await client().post(`/api/v1/work-items/${itemId}/start`);
+    return res.data;
+}
+export async function completeWorkItem(itemId, data) {
+    const res = await client().post(`/api/v1/work-items/${itemId}/complete`, data);
+    return res.data;
+}
+export async function blockWorkItem(itemId, data) {
+    const res = await client().post(`/api/v1/work-items/${itemId}/block`, data);
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// My Tasks
+// ---------------------------------------------------------------------------
+export async function getMyTasks() {
+    const res = await client().get("/api/v1/work-items/mine");
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Work Item Context
+// ---------------------------------------------------------------------------
+export async function getWorkItemContext(itemId) {
+    const res = await client().get(`/api/v1/work-items/${itemId}/context`);
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Queue
+// ---------------------------------------------------------------------------
+export async function queueNext(repoId) {
+    const params = {};
+    if (repoId)
+        params.repo_id = repoId;
+    const res = await client().get("/api/v1/queue/next", { params });
+    return res.data;
+}
+export async function myTasksNext(repoId) {
+    const params = {};
+    if (repoId)
+        params.repo_id = repoId;
+    const res = await client().get("/api/v1/my-tasks/next", { params });
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Edges
+// ---------------------------------------------------------------------------
+export async function createEdge(repoId, data) {
+    const res = await client().post(`/api/v1/repos/${repoId}/work-item-edges/`, data);
+    return res.data;
+}
+export async function listEdges(repoId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/work-item-edges/`);
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Schedule
+// ---------------------------------------------------------------------------
+export async function scheduleProject(projectId, startDate) {
+    const res = await client().post(`/api/v1/projects/${projectId}/schedule`, { start_date: startDate });
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Signals
+// ---------------------------------------------------------------------------
+export async function createSignal(workItemId, signal) {
+    const res = await client().post(`/api/v1/work-items/${workItemId}/signals`, signal);
+    return res.data;
+}
+export async function listSignals(workItemId) {
+    const res = await client().get(`/api/v1/work-items/${workItemId}/signals`);
+    return res.data;
+}
+export async function getSignalHealth(workItemId) {
+    const res = await client().get(`/api/v1/work-items/${workItemId}/signals/health`);
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// Users
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// AI Models
+// ---------------------------------------------------------------------------
+export async function listAIModels() {
+    const res = await client().get("/api/v1/ai-models");
+    return res.data;
+}
+export async function listAvailableModels() {
+    const res = await client().get("/api/v1/ai-models/available");
+    return res.data;
+}
+export async function listModelsByTier(tier) {
+    const res = await client().get(`/api/v1/ai-models/available/tier/${tier}`);
+    return res.data;
+}
+export async function getMyModels() {
+    const res = await client().get("/api/v1/users/me/ai-models");
+    return res.data;
+}
+export async function setMyModels(modelIds) {
+    await client().put("/api/v1/users/me/ai-models", { model_ids: modelIds });
+}
+// ---------------------------------------------------------------------------
+// Users
+// ---------------------------------------------------------------------------
+export async function listUsers(role) {
+    const params = {};
+    if (role)
+        params.role = role;
+    const res = await client().get("/api/v1/users/", { params });
+    return res.data;
+}
+// ---------------------------------------------------------------------------
+// References
+// ---------------------------------------------------------------------------
+export async function listReferences(workItemId, inherited) {
+    const path = inherited
+        ? `/api/v1/work-items/${workItemId}/references/inherited`
+        : `/api/v1/work-items/${workItemId}/references`;
+    const res = await client().get(path);
+    return res.data;
+}
+export async function createReference(workItemId, data) {
+    const res = await client().post(`/api/v1/work-items/${workItemId}/references`, data);
+    return res.data;
+}
+export async function deleteReference(workItemId, refId) {
+    await client().delete(`/api/v1/work-items/${workItemId}/references/${refId}`);
+}
+// ---------------------------------------------------------------------------
+// Documents
+// ---------------------------------------------------------------------------
+export async function listDocuments(repoId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/documents/`);
+    return res.data;
+}
+export async function uploadDocument(repoId, filename, content, contentType) {
+    const form = new FormData();
+    form.append("file", content, { filename, contentType: contentType ?? "text/markdown" });
+    const res = await client().post(`/api/v1/repos/${repoId}/documents/`, form, {
+        headers: form.getHeaders(),
+    });
+    return res.data;
+}
+export async function getDocument(repoId, docId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/documents/${docId}`);
+    return res.data;
+}
+export async function getDocumentContent(repoId, docId) {
+    const res = await client().get(`/api/v1/repos/${repoId}/documents/${docId}/content`, {
+        responseType: "text",
+    });
+    return res.data;
+}
+export async function deleteDocument(repoId, docId) {
+    await client().delete(`/api/v1/repos/${repoId}/documents/${docId}`);
+}
+// ---------------------------------------------------------------------------
+// Telemetry
+// ---------------------------------------------------------------------------
+export async function createTelemetry(workItemId, input) {
+    const res = await client().post(`/api/v1/work-items/${workItemId}/telemetry`, input);
+    return res.data;
+}
+export const reportTelemetry = createTelemetry;
+export async function listTelemetry(workItemId) {
+    const res = await client().get(`/api/v1/work-items/${workItemId}/telemetry`);
+    return res.data;
+}
+//# sourceMappingURL=api.js.map