@xfey/tutti 0.1.0

package/dist/server-shell/http/routes/project-api/openapi-diagnostic-routes.js

@@ -0,0 +1,17 @@
+import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
+import { OpenApiDocumentProjectionSchema } from "./schemas.js";
+export const HOST_PROJECT_DIAGNOSTIC_OPENAPI_ROUTES = [
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/openapi.json`,
+        summary: "Return the browser-facing Host Project API OpenAPI diagnostic document.",
+        tags: ["diagnostics"],
+        responses: {
+            200: {
+                description: "OpenAPI diagnostic document.",
+                schema: OpenApiDocumentProjectionSchema,
+            },
+        },
+    },
+];
+//# sourceMappingURL=openapi-diagnostic-routes.js.map

package/dist/server-shell/http/routes/project-api/openapi-execution-routes.d.ts

@@ -0,0 +1,215 @@
+export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                module_id: import("@sinclair/typebox").TString;
+                title: import("@sinclair/typebox").TString;
+                summary: import("@sinclair/typebox").TString;
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                order: import("@sinclair/typebox").TInteger;
+                current_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                active_clarification_thread_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                created_from_workflow_ref: import("@sinclair/typebox").TString;
+                created_at: import("@sinclair/typebox").TString;
+                updated_at: import("@sinclair/typebox").TString;
+            }>;
+        };
+    };
+    querystring?: never;
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                task: import("@sinclair/typebox").TObject<{
+                    id: import("@sinclair/typebox").TString;
+                    module_id: import("@sinclair/typebox").TString;
+                    title: import("@sinclair/typebox").TString;
+                    summary: import("@sinclair/typebox").TString;
+                    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                    order: import("@sinclair/typebox").TInteger;
+                    current_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    active_clarification_thread_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    created_from_workflow_ref: import("@sinclair/typebox").TString;
+                    created_at: import("@sinclair/typebox").TString;
+                    updated_at: import("@sinclair/typebox").TString;
+                }>;
+                detail: import("@sinclair/typebox").TObject<{
+                    task_id: import("@sinclair/typebox").TString;
+                    contract: import("@sinclair/typebox").TObject<{
+                        goal: import("@sinclair/typebox").TString;
+                        scope: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                    }>;
+                    result: import("@sinclair/typebox").TObject<{
+                        latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        result_kind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"needs_human">, import("@sinclair/typebox").TLiteral<"finished">, import("@sinclair/typebox").TLiteral<"failed">]>>;
+                        run_lineage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            attempt: import("@sinclair/typebox").TInteger;
+                            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"initial">, import("@sinclair/typebox").TLiteral<"continuation">, import("@sinclair/typebox").TLiteral<"retry">]>;
+                            parent_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            root_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        clarification_thread_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        outcome: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">]>>;
+                        summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        checks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"passed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"skipped">]>>;
+                        docs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"updated">, import("@sinclair/typebox").TLiteral<"checked_no_change">, import("@sinclair/typebox").TLiteral<"not_checked">, import("@sinclair/typebox").TLiteral<"sync_deferred">]>>;
+                        skip_reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"no_validation_command_found">, import("@sinclair/typebox").TLiteral<"project_has_no_test_setup">, import("@sinclair/typebox").TLiteral<"validation_not_applicable">, import("@sinclair/typebox").TLiteral<"command_prerequisite_missing">, import("@sinclair/typebox").TLiteral<"command_requires_external_service">, import("@sinclair/typebox").TLiteral<"command_requires_secret">, import("@sinclair/typebox").TLiteral<"command_requires_interactive_input">, import("@sinclair/typebox").TLiteral<"command_too_expensive_for_mvp">, import("@sinclair/typebox").TLiteral<"unsafe_command_blocked">, import("@sinclair/typebox").TLiteral<"known_failing_baseline">]>>;
+                        skip_reason_summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        external_side_effects: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                            status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"succeeded">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+                            target: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            redacted_summary: import("@sinclair/typebox").TString;
+                            started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            finished_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>>;
+                        changed_paths: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                        promotion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"promoted">, import("@sinclair/typebox").TLiteral<"not_promoted">, import("@sinclair/typebox").TLiteral<"not_attempted">]>;
+                            summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            reason_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            commit_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        }>>;
+                        error_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        retryable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+                        updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    }>;
+                    frozen_contract_since_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    updated_at: import("@sinclair/typebox").TString;
+                }>;
+            }>;
+        };
+    };
+    querystring?: never;
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    querystring: import("@sinclair/typebox").TObject<{
+        cursor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>;
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TSchema;
+        };
+    };
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    querystring: import("@sinclair/typebox").TObject<{
+        cursor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>;
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TSchema;
+        };
+    };
+    parameters?: never;
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                recovery_summary: import("@sinclair/typebox").TObject<{
+                    recovery_summary_id: import("@sinclair/typebox").TString;
+                    summary: import("@sinclair/typebox").TString;
+                    affected_activities: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                    affected_activity_count: import("@sinclair/typebox").TInteger;
+                    created_at: import("@sinclair/typebox").TString;
+                }>;
+            }>;
+        };
+    };
+    querystring?: never;
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                summary: import("@sinclair/typebox").TString;
+                active_task: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    id: import("@sinclair/typebox").TString;
+                    module_id: import("@sinclair/typebox").TString;
+                    title: import("@sinclair/typebox").TString;
+                    summary: import("@sinclair/typebox").TString;
+                    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                    order: import("@sinclair/typebox").TInteger;
+                    current_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    active_clarification_thread_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    latest_run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    created_from_workflow_ref: import("@sinclair/typebox").TString;
+                    created_at: import("@sinclair/typebox").TString;
+                    updated_at: import("@sinclair/typebox").TString;
+                }>>;
+                active_activity: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    activity_ref: import("@sinclair/typebox").TString;
+                    activity_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"procedure">]>;
+                    workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    workflow_kind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"project_context_bootstrap">, import("@sinclair/typebox").TLiteral<"scratchpad_refresh">, import("@sinclair/typebox").TLiteral<"task_compile">, import("@sinclair/typebox").TLiteral<"context_sync">, import("@sinclair/typebox").TLiteral<"reference_summary_refresh">, import("@sinclair/typebox").TLiteral<"recovery_check">, import("@sinclair/typebox").TLiteral<"follow_up_check">]>>;
+                    lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
+                    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                }>>;
+                active_activities: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                    activity_ref: import("@sinclair/typebox").TString;
+                    activity_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"procedure">]>;
+                    workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    workflow_kind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"project_context_bootstrap">, import("@sinclair/typebox").TLiteral<"scratchpad_refresh">, import("@sinclair/typebox").TLiteral<"task_compile">, import("@sinclair/typebox").TLiteral<"context_sync">, import("@sinclair/typebox").TLiteral<"reference_summary_refresh">, import("@sinclair/typebox").TLiteral<"recovery_check">, import("@sinclair/typebox").TLiteral<"follow_up_check">]>>;
+                    lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
+                    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                }>>>;
+                blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"clarification">;
+                    thread_id: import("@sinclair/typebox").TString;
+                    round_id: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"approval">;
+                    approval_id: import("@sinclair/typebox").TString;
+                }>]>>;
+                last_conclusion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"needs_human">, import("@sinclair/typebox").TLiteral<"recovered">]>;
+                    summary: import("@sinclair/typebox").TString;
+                    task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    occurred_at: import("@sinclair/typebox").TString;
+                }>>;
+                updated_at: import("@sinclair/typebox").TString;
+            }>;
+        };
+    };
+    parameters?: never;
+    querystring?: never;
+})[];
+//# sourceMappingURL=openapi-execution-routes.d.ts.map

package/dist/server-shell/http/routes/project-api/openapi-execution-routes.js

@@ -0,0 +1,75 @@
+import { CursorPageRequestSchema, ExecutionStatusProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, TaskDetailProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, } from "@tutti/shared/schemas/api";
+import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
+import { RecoverySummaryIdPathParameter, TaskIdPathParameter, } from "./openapi-path-parameters.js";
+export const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES = [
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/tasks/{task_id}`,
+        summary: "Read one task projection.",
+        tags: ["tasks"],
+        parameters: [TaskIdPathParameter],
+        responses: {
+            200: { description: "Task projection.", schema: TaskProjectionSchema },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/tasks/{task_id}/detail`,
+        summary: "Read one task detail projection.",
+        tags: ["tasks"],
+        parameters: [TaskIdPathParameter],
+        responses: {
+            200: { description: "Task detail projection.", schema: TaskDetailProjectionSchema },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/tasks/{task_id}/run-results`,
+        summary: "Read task run result history.",
+        tags: ["tasks"],
+        parameters: [TaskIdPathParameter],
+        querystring: CursorPageRequestSchema,
+        responses: {
+            200: { description: "Task run result history page.", schema: TaskRunResultsPageSchema },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/recovery-summaries`,
+        summary: "Read recovery summary history.",
+        tags: ["recovery"],
+        querystring: GetRecoverySummariesRequestSchema,
+        responses: {
+            200: {
+                description: "Recovery summary page.",
+                schema: GetRecoverySummariesResponseSchema,
+            },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/recovery-summaries/{recovery_summary_id}`,
+        summary: "Read one recovery summary.",
+        tags: ["recovery"],
+        parameters: [RecoverySummaryIdPathParameter],
+        responses: {
+            200: {
+                description: "Recovery summary response.",
+                schema: GetRecoverySummaryResponseSchema,
+            },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/execution-status`,
+        summary: "Read current execution status.",
+        tags: ["execution"],
+        responses: {
+            200: {
+                description: "Execution status projection.",
+                schema: ExecutionStatusProjectionSchema,
+            },
+        },
+    },
+];
+//# sourceMappingURL=openapi-execution-routes.js.map

package/dist/server-shell/http/routes/project-api/openapi-path-parameters.d.ts

@@ -0,0 +1,9 @@
+import { type BrowserFacingOpenApiParameter } from "@tutti/shared/schemas/api";
+export declare function pathParameter(name: string, schema: unknown, description: string): BrowserFacingOpenApiParameter;
+export declare const TaskIdPathParameter: BrowserFacingOpenApiParameter;
+export declare const RecoverySummaryIdPathParameter: BrowserFacingOpenApiParameter;
+export declare const ApprovalRequestIdPathParameter: BrowserFacingOpenApiParameter;
+export declare const ClarificationThreadIdPathParameter: BrowserFacingOpenApiParameter;
+export declare const ClarificationRoundIdPathParameter: BrowserFacingOpenApiParameter;
+export declare const SkillNamePathParameter: BrowserFacingOpenApiParameter;
+//# sourceMappingURL=openapi-path-parameters.d.ts.map

package/dist/server-shell/http/routes/project-api/openapi-path-parameters.js

@@ -0,0 +1,18 @@
+import { SkillNameSchema, } from "@tutti/shared/schemas/api";
+import { ApprovalRequestIdSchema, ClarificationRoundRefSchema, ClarificationThreadRefSchema, RecoverySummaryIdSchema, TaskIdSchema, } from "@tutti/shared/schemas/domain";
+export function pathParameter(name, schema, description) {
+    return {
+        name,
+        in: "path",
+        required: true,
+        description,
+        schema,
+    };
+}
+export const TaskIdPathParameter = pathParameter("task_id", TaskIdSchema, "Task id.");
+export const RecoverySummaryIdPathParameter = pathParameter("recovery_summary_id", RecoverySummaryIdSchema, "Recovery summary id.");
+export const ApprovalRequestIdPathParameter = pathParameter("approval_id", ApprovalRequestIdSchema, "Approval request id.");
+export const ClarificationThreadIdPathParameter = pathParameter("thread_id", ClarificationThreadRefSchema, "Clarification thread id.");
+export const ClarificationRoundIdPathParameter = pathParameter("round_id", ClarificationRoundRefSchema, "Clarification round id.");
+export const SkillNamePathParameter = pathParameter("skill_name", SkillNameSchema, "Skill name.");
+//# sourceMappingURL=openapi-path-parameters.js.map

package/dist/server-shell/http/routes/project-api/openapi-skills-routes.d.ts

@@ -0,0 +1,60 @@
+export declare const HOST_PROJECT_SKILLS_OPENAPI_ROUTES: ({
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                    name: import("@sinclair/typebox").TString;
+                    description: import("@sinclair/typebox").TString;
+                    short_description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    enabled: import("@sinclair/typebox").TBoolean;
+                    source: import("@sinclair/typebox").TLiteral<"user">;
+                    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                }>>;
+            }>;
+        };
+    };
+    parameters?: never;
+    requestBody?: never;
+} | {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    parameters: import("@tutti/shared/schemas/api").BrowserFacingOpenApiParameter[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                skill: import("@sinclair/typebox").TObject<{
+                    name: import("@sinclair/typebox").TString;
+                    description: import("@sinclair/typebox").TString;
+                    short_description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    enabled: import("@sinclair/typebox").TBoolean;
+                    source: import("@sinclair/typebox").TLiteral<"user">;
+                    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    skill_md: import("@sinclair/typebox").TString;
+                }>;
+            }>;
+        };
+    };
+    requestBody?: never;
+} | {
+    method: "post";
+    path: string;
+    summary: string;
+    tags: string[];
+    requestBody: import("@sinclair/typebox").TSchema;
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TSchema;
+        };
+    };
+    parameters?: never;
+})[];
+//# sourceMappingURL=openapi-skills-routes.d.ts.map

package/dist/server-shell/http/routes/project-api/openapi-skills-routes.js

@@ -0,0 +1,51 @@
+import { DeleteSkillBodySchema, DeleteSkillResponseSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipResponseSchema, } from "@tutti/shared/schemas/api";
+import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
+import { SkillNamePathParameter } from "./openapi-path-parameters.js";
+export const HOST_PROJECT_SKILLS_OPENAPI_ROUTES = [
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/skills`,
+        summary: "List host machine-local user skills.",
+        tags: ["skills"],
+        responses: {
+            200: { description: "User skills projection.", schema: GetSkillsResponseSchema },
+        },
+    },
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/skills/{skill_name}`,
+        summary: "Read one host machine-local user skill.",
+        tags: ["skills"],
+        parameters: [SkillNamePathParameter],
+        responses: {
+            200: { description: "User skill detail projection.", schema: GetSkillResponseSchema },
+        },
+    },
+    {
+        method: "post",
+        path: `${HOST_PROJECT_API_BASE_PATH}/skills/import`,
+        summary: "Import a zipped user skill.",
+        tags: ["skills", "commands"],
+        requestBody: ImportSkillZipBodySchema,
+        responses: {
+            200: {
+                description: "Skill import command disposition.",
+                schema: ImportSkillZipResponseSchema,
+            },
+        },
+    },
+    {
+        method: "post",
+        path: `${HOST_PROJECT_API_BASE_PATH}/skills/delete`,
+        summary: "Delete a user skill.",
+        tags: ["skills", "commands"],
+        requestBody: DeleteSkillBodySchema,
+        responses: {
+            200: {
+                description: "Skill delete command disposition.",
+                schema: DeleteSkillResponseSchema,
+            },
+        },
+    },
+];
+//# sourceMappingURL=openapi-skills-routes.js.map

package/dist/server-shell/http/routes/project-api/openapi-timeline-routes.d.ts

@@ -0,0 +1,115 @@
+export declare const HOST_PROJECT_TIMELINE_OPENAPI_ROUTES: {
+    method: "get";
+    path: string;
+    summary: string;
+    tags: string[];
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                generated_at: import("@sinclair/typebox").TString;
+                usage_overview: import("@sinclair/typebox").TObject<{
+                    total_tokens: import("@sinclair/typebox").TInteger;
+                    totals: import("@sinclair/typebox").TObject<{
+                        input_tokens: import("@sinclair/typebox").TInteger;
+                        cached_input_tokens: import("@sinclair/typebox").TInteger;
+                        output_tokens: import("@sinclair/typebox").TInteger;
+                        reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                        event_count: import("@sinclair/typebox").TInteger;
+                    }>;
+                    by_source: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                        source: import("@sinclair/typebox").TString;
+                        label: import("@sinclair/typebox").TString;
+                        category: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"implementation">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"context">, import("@sinclair/typebox").TLiteral<"qna">, import("@sinclair/typebox").TLiteral<"other">]>;
+                        input_tokens: import("@sinclair/typebox").TInteger;
+                        cached_input_tokens: import("@sinclair/typebox").TInteger;
+                        output_tokens: import("@sinclair/typebox").TInteger;
+                        reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                        event_count: import("@sinclair/typebox").TInteger;
+                    }>>;
+                    by_model: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                        model: import("@sinclair/typebox").TString;
+                        input_tokens: import("@sinclair/typebox").TInteger;
+                        cached_input_tokens: import("@sinclair/typebox").TInteger;
+                        output_tokens: import("@sinclair/typebox").TInteger;
+                        reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                        event_count: import("@sinclair/typebox").TInteger;
+                    }>>;
+                    recent_windows: import("@sinclair/typebox").TObject<{
+                        today: import("@sinclair/typebox").TObject<{
+                            input_tokens: import("@sinclair/typebox").TInteger;
+                            cached_input_tokens: import("@sinclair/typebox").TInteger;
+                            output_tokens: import("@sinclair/typebox").TInteger;
+                            reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                            total_tokens: import("@sinclair/typebox").TInteger;
+                            event_count: import("@sinclair/typebox").TInteger;
+                        }>;
+                        last_7_days: import("@sinclair/typebox").TObject<{
+                            input_tokens: import("@sinclair/typebox").TInteger;
+                            cached_input_tokens: import("@sinclair/typebox").TInteger;
+                            output_tokens: import("@sinclair/typebox").TInteger;
+                            reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                            total_tokens: import("@sinclair/typebox").TInteger;
+                            event_count: import("@sinclair/typebox").TInteger;
+                        }>;
+                        last_30_days: import("@sinclair/typebox").TObject<{
+                            input_tokens: import("@sinclair/typebox").TInteger;
+                            cached_input_tokens: import("@sinclair/typebox").TInteger;
+                            output_tokens: import("@sinclair/typebox").TInteger;
+                            reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                            total_tokens: import("@sinclair/typebox").TInteger;
+                            event_count: import("@sinclair/typebox").TInteger;
+                        }>;
+                    }>;
+                }>;
+                items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                    id: import("@sinclair/typebox").TString;
+                    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"procedure">, import("@sinclair/typebox").TLiteral<"commit">, import("@sinclair/typebox").TLiteral<"usage">, import("@sinclair/typebox").TLiteral<"clarification">, import("@sinclair/typebox").TLiteral<"checks">, import("@sinclair/typebox").TLiteral<"promotion">, import("@sinclair/typebox").TLiteral<"recovery">]>;
+                    occurred_at: import("@sinclair/typebox").TString;
+                    title: import("@sinclair/typebox").TString;
+                    summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    task_title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    commit_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    commit_short_oid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"needs_human">, import("@sinclair/typebox").TLiteral<"skipped">]>>;
+                    token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        input_tokens: import("@sinclair/typebox").TInteger;
+                        cached_input_tokens: import("@sinclair/typebox").TInteger;
+                        output_tokens: import("@sinclair/typebox").TInteger;
+                        reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                        event_count: import("@sinclair/typebox").TInteger;
+                    }>>;
+                    usage_sources: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                        source: import("@sinclair/typebox").TString;
+                        label: import("@sinclair/typebox").TString;
+                        category: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"implementation">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"context">, import("@sinclair/typebox").TLiteral<"qna">, import("@sinclair/typebox").TLiteral<"other">]>;
+                        input_tokens: import("@sinclair/typebox").TInteger;
+                        cached_input_tokens: import("@sinclair/typebox").TInteger;
+                        output_tokens: import("@sinclair/typebox").TInteger;
+                        reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                        event_count: import("@sinclair/typebox").TInteger;
+                    }>>>;
+                    usage_models: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                        model: import("@sinclair/typebox").TString;
+                        input_tokens: import("@sinclair/typebox").TInteger;
+                        cached_input_tokens: import("@sinclair/typebox").TInteger;
+                        output_tokens: import("@sinclair/typebox").TInteger;
+                        reasoning_output_tokens: import("@sinclair/typebox").TInteger;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                        event_count: import("@sinclair/typebox").TInteger;
+                    }>>>;
+                    meta: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                }>>;
+            }>;
+        };
+    };
+}[];
+//# sourceMappingURL=openapi-timeline-routes.d.ts.map

package/dist/server-shell/http/routes/project-api/openapi-timeline-routes.js

@@ -0,0 +1,17 @@
+import { ProjectTimelineResponseSchema, } from "@tutti/shared/schemas/api";
+import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
+export const HOST_PROJECT_TIMELINE_OPENAPI_ROUTES = [
+    {
+        method: "get",
+        path: `${HOST_PROJECT_API_BASE_PATH}/project-timeline`,
+        summary: "Read project timeline and token usage overview.",
+        tags: ["timeline"],
+        responses: {
+            200: {
+                description: "Project timeline projection.",
+                schema: ProjectTimelineResponseSchema,
+            },
+        },
+    },
+];
+//# sourceMappingURL=openapi-timeline-routes.js.map