@classic-homes/agent-contracts 0.0.0-stage → 0.1.1

package/dist/events.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+/** Client-generated identifier for one chat turn; also used for cancellation and log correlation. */
+export declare const RequestId: z.ZodUUID;
+export type RequestId = z.infer<typeof RequestId>;
+/** Identifier for a proposed document operation; prevents double application. */
+export declare const OperationId: z.ZodUUID;
+export type OperationId = z.infer<typeof OperationId>;
+/**
+ * Conversation identifier. Opaque: the backend assigns it, so it is not required to be a UUID.
+ */
+export declare const ConversationId: z.ZodString;
+export type ConversationId = z.infer<typeof ConversationId>;
+/**
+ * Opaque per-document identifier issued by the task pane for the life of the open
+ * document. Office does not provide a stable cross-session document ID.
+ */
+export declare const DocumentId: z.ZodString;
+export type DocumentId = z.infer<typeof DocumentId>;
+/** Logical agent key from the catalog (never a backend database ID). */
+export declare const AgentKey: z.ZodString;
+export type AgentKey = z.infer<typeof AgentKey>;
+export declare const FileId: z.ZodString;
+export type FileId = z.infer<typeof FileId>;
+/** One agent run inside a turn: the router's run, or a delegated child's run. */
+export declare const RunId: z.ZodString;
+export type RunId = z.infer<typeof RunId>;
+export declare const ToolCallId: z.ZodString;
+export type ToolCallId = z.infer<typeof ToolCallId>;
+export declare const ArtifactId: z.ZodString;
+export type ArtifactId = z.infer<typeof ArtifactId>;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qGAAqG;AACrG,eAAO,MAAM,SAAS,WAAW,CAAC;AAClC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,iFAAiF;AACjF,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,cAAc,aAIC,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,UAAU,aAA6B,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,wEAAwE;AACxE,eAAO,MAAM,QAAQ,aAIW,CAAC;AACjC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAShD,eAAO,MAAM,MAAM,aAAW,CAAC;AAC/B,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,iFAAiF;AACjF,eAAO,MAAM,KAAK,aAAW,CAAC;AAC9B,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,aAAW,CAAC;AACnC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,UAAU,aAAW,CAAC;AACnC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/ids.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/** Client-generated identifier for one chat turn; also used for cancellation and log correlation. */
+export const RequestId = z.uuid();
+/** Identifier for a proposed document operation; prevents double application. */
+export const OperationId = z.uuid();
+/**
+ * Conversation identifier. Opaque: the backend assigns it, so it is not required to be a UUID.
+ */
+export const ConversationId = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[A-Za-z0-9_-]+$/);
+/**
+ * Opaque per-document identifier issued by the task pane for the life of the open
+ * document. Office does not provide a stable cross-session document ID.
+ */
+export const DocumentId = z.string().min(1).max(200);
+/** Logical agent key from the catalog (never a backend database ID). */
+export const AgentKey = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9][a-z0-9-]*$/);
+/** Opaque backend-issued identifiers for uploaded files, agent runs, tool calls and artifacts. */
+const opaqueId = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[A-Za-z0-9_.:-]+$/);
+export const FileId = opaqueId;
+/** One agent run inside a turn: the router's run, or a delegated child's run. */
+export const RunId = opaqueId;
+export const ToolCallId = opaqueId;
+export const ArtifactId = opaqueId;
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qGAAqG;AACrG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAGlC,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAGpC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAG7B;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAGrD,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAGjC,kGAAkG;AAClG,MAAM,QAAQ,GAAG,CAAC;KACf,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAE/B,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;AAG/B,iFAAiF;AACjF,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC;AAG9B,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAGnC,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './a1.js';
+export * from './api.js';
+export * from './auth.js';
+export * from './chat.js';
+export * from './context.js';
+export * from './events.js';
+export * from './ids.js';
+export * from './limits.js';
+export * from './operations.js';
+export * from './sse.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from './a1.js';
+export * from './api.js';
+export * from './auth.js';
+export * from './chat.js';
+export * from './context.js';
+export * from './events.js';
+export * from './ids.js';
+export * from './limits.js';
+export * from './operations.js';
+export * from './sse.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/limits.d.ts

@@ -0,0 +1,30 @@
+/** Bounds enforced on both sides of the wire. Change them here only. */
+export declare const LIMITS: {
+    /** Maximum characters in one user chat message. */
+    readonly messageChars: 8000;
+    /** Maximum cells in a captured Excel selection or a proposed Excel write. */
+    readonly excelCells: 2500;
+    /** Maximum characters in a single Excel cell value or formula. */
+    readonly excelCellChars: 8192;
+    /** Maximum characters of captured Word selection text or proposed Word text. */
+    readonly wordChars: 20000;
+    /** Maximum operation results reported back with one chat request. */
+    readonly operationResults: 20;
+    /** Maximum characters of user-highlighted text sent as Classic App page context. */
+    readonly appSelectionChars: 4000;
+    /** Maximum whitelisted facts a Classic App page may attach as context. */
+    readonly appFacts: 40;
+    /** Maximum characters in one app context fact value. */
+    readonly appFactChars: 300;
+    /** Maximum uploaded files referenced by one chat request. */
+    readonly requestFiles: 20;
+    /** Maximum bytes of one uploaded file. */
+    readonly fileBytes: number;
+    /** Maximum characters in a tool call argument or result preview event. */
+    readonly toolPreviewChars: 500;
+    /** Maximum characters of sandboxed HTML in one MCP-UI event. */
+    readonly uiHtmlChars: 512000;
+    /** Maximum characters of artifact text carried by one artifact event. */
+    readonly artifactDeltaChars: 64000;
+};
+//# sourceMappingURL=limits.d.ts.map

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,MAAM;IACjB,mDAAmD;;IAEnD,6EAA6E;;IAE7E,kEAAkE;;IAElE,gFAAgF;;IAEhF,qEAAqE;;IAErE,oFAAoF;;IAEpF,0EAA0E;;IAE1E,wDAAwD;;IAExD,6DAA6D;;IAE7D,0CAA0C;;IAE1C,0EAA0E;;IAE1E,gEAAgE;;IAEhE,yEAAyE;;CAEjE,CAAC"}

package/dist/limits.js

@@ -0,0 +1,30 @@
+/** Bounds enforced on both sides of the wire. Change them here only. */
+export const LIMITS = {
+    /** Maximum characters in one user chat message. */
+    messageChars: 8_000,
+    /** Maximum cells in a captured Excel selection or a proposed Excel write. */
+    excelCells: 2_500,
+    /** Maximum characters in a single Excel cell value or formula. */
+    excelCellChars: 8_192,
+    /** Maximum characters of captured Word selection text or proposed Word text. */
+    wordChars: 20_000,
+    /** Maximum operation results reported back with one chat request. */
+    operationResults: 20,
+    /** Maximum characters of user-highlighted text sent as Classic App page context. */
+    appSelectionChars: 4_000,
+    /** Maximum whitelisted facts a Classic App page may attach as context. */
+    appFacts: 40,
+    /** Maximum characters in one app context fact value. */
+    appFactChars: 300,
+    /** Maximum uploaded files referenced by one chat request. */
+    requestFiles: 20,
+    /** Maximum bytes of one uploaded file. */
+    fileBytes: 25 * 1024 * 1024,
+    /** Maximum characters in a tool call argument or result preview event. */
+    toolPreviewChars: 500,
+    /** Maximum characters of sandboxed HTML in one MCP-UI event. */
+    uiHtmlChars: 512_000,
+    /** Maximum characters of artifact text carried by one artifact event. */
+    artifactDeltaChars: 64_000,
+};
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,mDAAmD;IACnD,YAAY,EAAE,KAAK;IACnB,6EAA6E;IAC7E,UAAU,EAAE,KAAK;IACjB,kEAAkE;IAClE,cAAc,EAAE,KAAK;IACrB,gFAAgF;IAChF,SAAS,EAAE,MAAM;IACjB,qEAAqE;IACrE,gBAAgB,EAAE,EAAE;IACpB,oFAAoF;IACpF,iBAAiB,EAAE,KAAK;IACxB,0EAA0E;IAC1E,QAAQ,EAAE,EAAE;IACZ,wDAAwD;IACxD,YAAY,EAAE,GAAG;IACjB,6DAA6D;IAC7D,YAAY,EAAE,EAAE;IAChB,0CAA0C;IAC1C,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IAC3B,0EAA0E;IAC1E,gBAAgB,EAAE,GAAG;IACrB,gEAAgE;IAChE,WAAW,EAAE,OAAO;IACpB,yEAAyE;IACzE,kBAAkB,EAAE,MAAM;CAClB,CAAC"}

package/dist/operations.d.ts

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+export declare const ExcelWriteRange: z.ZodObject<{
+    target: z.ZodObject<{
+        sheet: z.ZodString;
+        address: z.ZodString;
+    }, z.core.$strip>;
+    write: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"values">;
+        values: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"formulas">;
+        formulas: z.ZodArray<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>], "type">;
+    precondition: z.ZodObject<{
+        formulas: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>>;
+    }, z.core.$strip>;
+    operationId: z.ZodUUID;
+    documentId: z.ZodString;
+    summary: z.ZodString;
+    kind: z.ZodLiteral<"excel.writeRange">;
+}, z.core.$strip>;
+export type ExcelWriteRange = z.infer<typeof ExcelWriteRange>;
+export declare const WordInsertText: z.ZodObject<{
+    target: z.ZodObject<{
+        targetId: z.ZodString;
+        expectedText: z.ZodString;
+    }, z.core.$strip>;
+    location: z.ZodEnum<{
+        before: "before";
+        after: "after";
+    }>;
+    text: z.ZodString;
+    operationId: z.ZodUUID;
+    documentId: z.ZodString;
+    summary: z.ZodString;
+    kind: z.ZodLiteral<"word.insertText">;
+}, z.core.$strip>;
+export type WordInsertText = z.infer<typeof WordInsertText>;
+export declare const WordReplaceSelection: z.ZodObject<{
+    target: z.ZodObject<{
+        targetId: z.ZodString;
+        expectedText: z.ZodString;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    operationId: z.ZodUUID;
+    documentId: z.ZodString;
+    summary: z.ZodString;
+    kind: z.ZodLiteral<"word.replaceSelection">;
+}, z.core.$strip>;
+export type WordReplaceSelection = z.infer<typeof WordReplaceSelection>;
+export declare const ProposedOperation: z.ZodUnion<readonly [z.ZodObject<{
+    target: z.ZodObject<{
+        sheet: z.ZodString;
+        address: z.ZodString;
+    }, z.core.$strip>;
+    write: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"values">;
+        values: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"formulas">;
+        formulas: z.ZodArray<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>], "type">;
+    precondition: z.ZodObject<{
+        formulas: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>>;
+    }, z.core.$strip>;
+    operationId: z.ZodUUID;
+    documentId: z.ZodString;
+    summary: z.ZodString;
+    kind: z.ZodLiteral<"excel.writeRange">;
+}, z.core.$strip>, z.ZodObject<{
+    target: z.ZodObject<{
+        targetId: z.ZodString;
+        expectedText: z.ZodString;
+    }, z.core.$strip>;
+    location: z.ZodEnum<{
+        before: "before";
+        after: "after";
+    }>;
+    text: z.ZodString;
+    operationId: z.ZodUUID;
+    documentId: z.ZodString;
+    summary: z.ZodString;
+    kind: z.ZodLiteral<"word.insertText">;
+}, z.core.$strip>, z.ZodObject<{
+    target: z.ZodObject<{
+        targetId: z.ZodString;
+        expectedText: z.ZodString;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    operationId: z.ZodUUID;
+    documentId: z.ZodString;
+    summary: z.ZodString;
+    kind: z.ZodLiteral<"word.replaceSelection">;
+}, z.core.$strip>]>;
+export type ProposedOperation = z.infer<typeof ProposedOperation>;
+export type OperationKind = ProposedOperation['kind'];
+export declare const OperationStatus: z.ZodEnum<{
+    pending: "pending";
+    applied: "applied";
+    failed: "failed";
+    rejected: "rejected";
+}>;
+export type OperationStatus = z.infer<typeof OperationStatus>;
+export declare const OperationFailureCode: z.ZodEnum<{
+    stale_target: "stale_target";
+    already_applied: "already_applied";
+    host_mismatch: "host_mismatch";
+    unsupported_api: "unsupported_api";
+    invalid_operation: "invalid_operation";
+    host_error: "host_error";
+    user_rejected: "user_rejected";
+}>;
+export type OperationFailureCode = z.infer<typeof OperationFailureCode>;
+/** Outcome of a proposal as confirmed by the host (or the user's rejection). */
+export declare const OperationResult: z.ZodObject<{
+    operationId: z.ZodUUID;
+    status: z.ZodEnum<{
+        pending: "pending";
+        applied: "applied";
+        failed: "failed";
+        rejected: "rejected";
+    }>;
+    code: z.ZodOptional<z.ZodEnum<{
+        stale_target: "stale_target";
+        already_applied: "already_applied";
+        host_mismatch: "host_mismatch";
+        unsupported_api: "unsupported_api";
+        invalid_operation: "invalid_operation";
+        host_error: "host_error";
+        user_rejected: "user_rejected";
+    }>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type OperationResult = z.infer<typeof OperationResult>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;iBA4CxB,CAAC;AACL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;iBAOzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAAmE,CAAC;AAClG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,eAAe;;;;;EAAuD,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,oBAAoB;;;;;;;;EAQ/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,gFAAgF;AAChF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAK1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/operations.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { parseA1Range } from './a1.js';
+import { A1Address, Grid, SheetName, WordTarget, gridMatchesAddress } from './context.js';
+import { DocumentId, OperationId } from './ids.js';
+import { LIMITS } from './limits.js';
+/**
+ * Allowlisted, schema-validated document operations. These are data, never code: the
+ * Office bridge interprets each `kind` itself. Nothing here is ever evaluated.
+ */
+const operationBase = {
+    operationId: OperationId,
+    documentId: DocumentId,
+    /** Short human-readable description shown in the review preview. */
+    summary: z.string().min(1).max(500),
+};
+/**
+ * Literal values. Strings are written as literal text even when they begin with `=`;
+ * the bridge must not let Excel reinterpret them as formulas.
+ */
+const ValuesWrite = z.object({ type: z.literal('values'), values: Grid });
+/** Formulas are only written when the reviewed operation explicitly asks for them. */
+const FormulasWrite = z.object({
+    type: z.literal('formulas'),
+    formulas: z.array(z.array(z.string().max(LIMITS.excelCellChars).regex(/^=/, 'Formulas must start with ='))),
+});
+export const ExcelWriteRange = z
+    .object({
+    kind: z.literal('excel.writeRange'),
+    ...operationBase,
+    target: z.object({ sheet: SheetName, address: A1Address }),
+    write: z.discriminatedUnion('type', [ValuesWrite, FormulasWrite]),
+    /** Snapshot of the target when proposed; apply is refused if the target changed. */
+    precondition: z.object({
+        formulas: Grid,
+        /**
+         * Optional value snapshot. In `formulas`, literal text `=x` and a formula `=x` look
+         * identical; when present, values are compared too.
+         */
+        values: Grid.optional(),
+    }),
+})
+    .superRefine((op, ctx) => {
+    const range = parseA1Range(op.target.address);
+    if (range && range.rowCount * range.columnCount > LIMITS.excelCells) {
+        ctx.addIssue({ code: 'custom', message: `Write exceeds ${LIMITS.excelCells} cells` });
+        return;
+    }
+    const grid = op.write.type === 'values' ? op.write.values : op.write.formulas;
+    if (!gridMatchesAddress(grid, op.target.address)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['write'],
+            message: 'write grid does not match target address',
+        });
+    }
+    if (op.precondition.values && !gridMatchesAddress(op.precondition.values, op.target.address)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['precondition', 'values'],
+            message: 'precondition values do not match target address',
+        });
+    }
+    if (!gridMatchesAddress(op.precondition.formulas, op.target.address)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['precondition'],
+            message: 'precondition does not match target address',
+        });
+    }
+});
+export const WordInsertText = z.object({
+    kind: z.literal('word.insertText'),
+    ...operationBase,
+    target: WordTarget,
+    /** Insert relative to the captured target. */
+    location: z.enum(['before', 'after']),
+    text: z.string().min(1).max(LIMITS.wordChars),
+});
+export const WordReplaceSelection = z.object({
+    kind: z.literal('word.replaceSelection'),
+    ...operationBase,
+    target: WordTarget,
+    text: z.string().max(LIMITS.wordChars),
+});
+export const ProposedOperation = z.union([ExcelWriteRange, WordInsertText, WordReplaceSelection]);
+export const OperationStatus = z.enum(['pending', 'applied', 'failed', 'rejected']);
+export const OperationFailureCode = z.enum([
+    'stale_target',
+    'already_applied',
+    'host_mismatch',
+    'unsupported_api',
+    'invalid_operation',
+    'host_error',
+    'user_rejected',
+]);
+/** Outcome of a proposal as confirmed by the host (or the user's rejection). */
+export const OperationResult = z.object({
+    operationId: OperationId,
+    status: OperationStatus,
+    code: OperationFailureCode.optional(),
+    message: z.string().max(1_000).optional(),
+});
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,20 @@
+import { ChatEvent, type DecodedChatEvent } from './events.js';
+/** Encode one chat event as a Server-Sent Events frame. */
+export declare function encodeSseEvent(event: ChatEvent): string;
+/**
+ * Incremental SSE decoder for chat streams. Feed it text chunks; it returns validated events.
+ * A frame whose type this build knows must match its schema or the decoder throws. A frame of
+ * an unknown type must still carry a valid envelope (`requestId`, `seq`) and is returned as
+ * `{ type: 'unknown' }` so callers keep their ordering checks and can ignore it.
+ */
+export declare class SseDecoder {
+    private buffer;
+    push(chunk: string): DecodedChatEvent[];
+    /** True when a partial frame is still buffered (e.g. the stream ended mid-event). */
+    get pending(): boolean;
+}
+/** Validate one decoded JSON event; see {@link SseDecoder}. */
+export declare function decodeEvent(raw: unknown): DecodedChatEvent;
+/** Narrow a decoded event to one this build knows. */
+export declare function isKnownEvent(event: DecodedChatEvent): event is ChatEvent;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9E,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEvD;AAID;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAM;IAEpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAkBvC,qFAAqF;IACrF,IAAI,OAAO,IAAI,OAAO,CAErB;CACF;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAS1D;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,IAAI,SAAS,CAExE"}

package/dist/sse.js

@@ -0,0 +1,54 @@
+import { ChatEvent, EventEnvelope } from './events.js';
+/** Encode one chat event as a Server-Sent Events frame. */
+export function encodeSseEvent(event) {
+    return `event: ${event.type}\nid: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n`;
+}
+const KNOWN_TYPES = new Set(ChatEvent.options.map((o) => o.shape.type.value));
+/**
+ * Incremental SSE decoder for chat streams. Feed it text chunks; it returns validated events.
+ * A frame whose type this build knows must match its schema or the decoder throws. A frame of
+ * an unknown type must still carry a valid envelope (`requestId`, `seq`) and is returned as
+ * `{ type: 'unknown' }` so callers keep their ordering checks and can ignore it.
+ */
+export class SseDecoder {
+    buffer = '';
+    push(chunk) {
+        this.buffer += chunk.replace(/\r\n/g, '\n');
+        const events = [];
+        let boundary = this.buffer.indexOf('\n\n');
+        while (boundary !== -1) {
+            const frame = this.buffer.slice(0, boundary);
+            this.buffer = this.buffer.slice(boundary + 2);
+            const data = frame
+                .split('\n')
+                .filter((line) => line.startsWith('data:'))
+                .map((line) => line.slice(5).replace(/^ /, ''))
+                .join('\n');
+            if (data)
+                events.push(decodeEvent(JSON.parse(data)));
+            boundary = this.buffer.indexOf('\n\n');
+        }
+        return events;
+    }
+    /** True when a partial frame is still buffered (e.g. the stream ended mid-event). */
+    get pending() {
+        return this.buffer.trim().length > 0;
+    }
+}
+/** Validate one decoded JSON event; see {@link SseDecoder}. */
+export function decodeEvent(raw) {
+    const envelope = EventEnvelope.parse(raw);
+    if (KNOWN_TYPES.has(envelope.type))
+        return ChatEvent.parse(raw);
+    return {
+        type: 'unknown',
+        requestId: envelope.requestId,
+        seq: envelope.seq,
+        rawType: envelope.type,
+    };
+}
+/** Narrow a decoded event to one this build knows. */
+export function isKnownEvent(event) {
+    return event.type !== 'unknown';
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAE9E,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,OAAO,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AACtF,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,GAAG,EAAE,CAAC;IAEpB,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAuB,EAAE,CAAC;QACtC,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,OAAO,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,KAAK;iBACf,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;iBAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;iBAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrD,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qFAAqF;IACrF,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO;QACL,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,OAAO,EAAE,QAAQ,CAAC,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@classic-homes/agent-contracts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "Runtime schemas shared by the gateway and task pane. No host, UI or server dependencies.",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "4.6.7"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Classic-Homes/classic-agent.git",
+    "directory": "packages/contracts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.