@maudecode/talaria-web-contracts 1.19.0 → 1.21.0

package/dist/checkpoint.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+export declare const CHECKPOINT_DIFF_MAX_BYTES: number;
+/** Project checkpoints can predate the chat; native reads never imply a session-only edit ledger. */
+export declare const CheckpointComparisonSchema: z.ZodObject<{
+    provenance: z.ZodEnum<{
+        native_owner: "native_owner";
+        direct_workspace: "direct_workspace";
+    }>;
+    baseline: z.ZodEnum<{
+        earliest_retained_project_checkpoint: "earliest_retained_project_checkpoint";
+        selected_checkpoint: "selected_checkpoint";
+    }>;
+    available: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodEnum<{
+        checkpoints_disabled: "checkpoints_disabled";
+        no_baseline: "no_baseline";
+        checkpoint_unavailable: "checkpoint_unavailable";
+        payload_too_large: "payload_too_large";
+        invalid_payload: "invalid_payload";
+        owner_unavailable: "owner_unavailable";
+    }>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const CheckpointReadSchema: z.ZodObject<{
+    diff: z.ZodString;
+    stat: z.ZodString;
+    comparison: z.ZodObject<{
+        provenance: z.ZodEnum<{
+            native_owner: "native_owner";
+            direct_workspace: "direct_workspace";
+        }>;
+        baseline: z.ZodEnum<{
+            earliest_retained_project_checkpoint: "earliest_retained_project_checkpoint";
+            selected_checkpoint: "selected_checkpoint";
+        }>;
+        available: z.ZodBoolean;
+        reason: z.ZodNullable<z.ZodEnum<{
+            checkpoints_disabled: "checkpoints_disabled";
+            no_baseline: "no_baseline";
+            checkpoint_unavailable: "checkpoint_unavailable";
+            payload_too_large: "payload_too_large";
+            invalid_payload: "invalid_payload";
+            owner_unavailable: "owner_unavailable";
+        }>>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const CheckpointDiffSchema: z.ZodObject<{
+    checkpoint: z.ZodString;
+    workspace: z.ZodString;
+    diff: z.ZodString;
+    files_changed: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        status: z.ZodString;
+    }, z.core.$strip>>;
+    total_changes: z.ZodNumber;
+    comparison: z.ZodOptional<z.ZodObject<{
+        provenance: z.ZodEnum<{
+            native_owner: "native_owner";
+            direct_workspace: "direct_workspace";
+        }>;
+        baseline: z.ZodEnum<{
+            earliest_retained_project_checkpoint: "earliest_retained_project_checkpoint";
+            selected_checkpoint: "selected_checkpoint";
+        }>;
+        available: z.ZodBoolean;
+        reason: z.ZodNullable<z.ZodEnum<{
+            checkpoints_disabled: "checkpoints_disabled";
+            no_baseline: "no_baseline";
+            checkpoint_unavailable: "checkpoint_unavailable";
+            payload_too_large: "payload_too_large";
+            invalid_payload: "invalid_payload";
+            owner_unavailable: "owner_unavailable";
+        }>>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CheckpointDiff = z.infer<typeof CheckpointDiffSchema>;

package/dist/checkpoint.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const CHECKPOINT_DIFF_MAX_BYTES = 4 * 1024 * 1024;
+/** Project checkpoints can predate the chat; native reads never imply a session-only edit ledger. */
+export const CheckpointComparisonSchema = z.object({
+    provenance: z.enum(['native_owner', 'direct_workspace']),
+    baseline: z.enum(['earliest_retained_project_checkpoint', 'selected_checkpoint']),
+    available: z.boolean(), reason: z.enum(['checkpoints_disabled', 'no_baseline', 'checkpoint_unavailable', 'payload_too_large', 'invalid_payload', 'owner_unavailable']).nullable(),
+    truncated: z.boolean(),
+});
+export const CheckpointReadSchema = z.object({ diff: z.string().max(CHECKPOINT_DIFF_MAX_BYTES), stat: z.string().max(CHECKPOINT_DIFF_MAX_BYTES), comparison: CheckpointComparisonSchema });
+export const CheckpointDiffSchema = z.object({
+    checkpoint: z.string(), workspace: z.string(), diff: z.string(),
+    files_changed: z.array(z.object({ file: z.string(), status: z.string() })), total_changes: z.number().int(),
+    comparison: CheckpointComparisonSchema.optional(),
+});
+//# sourceMappingURL=checkpoint.js.map

package/dist/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AACxD,qGAAqG;AACrG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,sCAAsC,EAAE,qBAAqB,CAAC,CAAC;IACjF,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,sBAAsB,EAAE,aAAa,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjL,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAA;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,UAAU,EAAE,0BAA0B,EAAE,CAAC,CAAA;AAC1L,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/D,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3G,UAAU,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAA"}

package/dist/context-detail.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+export declare const ContextCategoryIdSchema: z.ZodEnum<{
+    system_prompt: "system_prompt";
+    tool_definitions: "tool_definitions";
+    rules: "rules";
+    skills: "skills";
+    mcp: "mcp";
+    subagent_definitions: "subagent_definitions";
+    memory: "memory";
+    conversation: "conversation";
+}>;
+/** A read of the existing owner only. Category estimates are independent of measured occupancy. */
+export declare const ContextDetailSchema: z.ZodObject<{
+    available: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodEnum<{
+        not_built: "not_built";
+        unsupported: "unsupported";
+        changed: "changed";
+        unavailable: "unavailable";
+    }>>;
+    used_tokens: z.ZodNullable<z.ZodNumber>;
+    window_tokens: z.ZodNullable<z.ZodNumber>;
+    estimated_total: z.ZodNullable<z.ZodNumber>;
+    source: z.ZodNullable<z.ZodEnum<{
+        local_estimate: "local_estimate";
+        provider_usage: "provider_usage";
+        provider_usage_plus_estimate: "provider_usage_plus_estimate";
+    }>>;
+    estimated: z.ZodNullable<z.ZodBoolean>;
+    categories: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            system_prompt: "system_prompt";
+            tool_definitions: "tool_definitions";
+            rules: "rules";
+            skills: "skills";
+            mcp: "mcp";
+            subagent_definitions: "subagent_definitions";
+            memory: "memory";
+            conversation: "conversation";
+        }>;
+        tokens: z.ZodNumber;
+        percent: z.ZodNullable<z.ZodNumber>;
+        estimated: z.ZodLiteral<true>;
+    }, z.core.$strip>>;
+    files: z.ZodArray<z.ZodObject<{
+        label: z.ZodEnum<{
+            "AGENTS.md": "AGENTS.md";
+            "SOUL.md": "SOUL.md";
+            ".hermes.md": ".hermes.md";
+            "CLAUDE.md": "CLAUDE.md";
+            "GEMINI.md": "GEMINI.md";
+            "CONTEXT.md": "CONTEXT.md";
+            "Context file": "Context file";
+        }>;
+        characters: z.ZodNullable<z.ZodNumber>;
+        tokens: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodEnum<{
+            truncated: "truncated";
+            unknown: "unknown";
+            loaded: "loaded";
+            flagged: "flagged";
+            shadowed: "shadowed";
+            blocked: "blocked";
+            empty: "empty";
+            unreadable: "unreadable";
+            suppressed: "suppressed";
+        }>;
+        loaded: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    truncated: z.ZodBoolean;
+    current_turn_output_tokens: z.ZodNullable<z.ZodNumber>;
+    last_turn_output_tokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type ContextDetail = z.infer<typeof ContextDetailSchema>;
+export declare const unavailableContextDetail: (reason?: NonNullable<ContextDetail["reason"]>) => ContextDetail;

package/dist/context-detail.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const Tokens = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).nullable();
+export const ContextCategoryIdSchema = z.enum(['system_prompt', 'tool_definitions', 'rules', 'skills', 'mcp', 'subagent_definitions', 'memory', 'conversation']);
+/** A read of the existing owner only. Category estimates are independent of measured occupancy. */
+export const ContextDetailSchema = z.object({
+    available: z.boolean(), reason: z.enum(['not_built', 'unsupported', 'changed', 'unavailable']).nullable(),
+    used_tokens: Tokens, window_tokens: Tokens, estimated_total: Tokens,
+    source: z.enum(['local_estimate', 'provider_usage', 'provider_usage_plus_estimate']).nullable(), estimated: z.boolean().nullable(),
+    categories: z.array(z.object({ id: ContextCategoryIdSchema, tokens: Tokens.unwrap(), percent: z.number().min(0).max(100).nullable(), estimated: z.literal(true) })).max(8),
+    files: z.array(z.object({ label: z.enum(['AGENTS.md', 'SOUL.md', '.hermes.md', 'CLAUDE.md', 'GEMINI.md', 'CONTEXT.md', 'Context file']), characters: Tokens, tokens: Tokens,
+        status: z.enum(['loaded', 'truncated', 'flagged', 'shadowed', 'blocked', 'empty', 'unreadable', 'suppressed', 'unknown']), loaded: z.boolean().nullable() })).max(64),
+    truncated: z.boolean(), current_turn_output_tokens: Tokens, last_turn_output_tokens: Tokens,
+});
+export const unavailableContextDetail = (reason = 'unavailable') => ({
+    available: false, reason, used_tokens: null, window_tokens: null, estimated_total: null, source: null, estimated: null,
+    categories: [], files: [], truncated: false, current_turn_output_tokens: null, last_turn_output_tokens: null,
+});
+//# sourceMappingURL=context-detail.js.map

package/dist/context-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail.js","sourceRoot":"","sources":["../src/context-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAA;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAA;AAChK,mGAAmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzG,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM;IACnE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,8BAA8B,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClI,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1K,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;QACzK,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACvK,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM;CAC5F,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAA+C,aAAa,EAAiB,EAAE,CAAC,CAAC;IACxH,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI;IACtH,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI;CAC7G,CAAC,CAAA"}