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

package/dist/a1.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Minimal A1 range parsing for bounded, single-area ranges without a sheet prefix,
+ * for example `B2` or `B2:D5`. Whole-row/column and multi-area references are rejected
+ * on purpose: proposals must name an exact bounded target.
+ */
+export interface A1Range {
+    /** Zero-based first row. */
+    row: number;
+    /** Zero-based first column. */
+    column: number;
+    rowCount: number;
+    columnCount: number;
+}
+export declare function parseA1Range(address: string): A1Range | null;
+export declare function columnName(index: number): string;
+export declare function formatA1Range(range: A1Range): string;
+//# sourceMappingURL=a1.d.ts.map

package/dist/a1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a1.d.ts","sourceRoot":"","sources":["../src/a1.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAc5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAShD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKpD"}

package/dist/a1.js

@@ -0,0 +1,51 @@
+const MAX_ROWS = 1_048_576;
+const MAX_COLUMNS = 16_384;
+const CELL = /^\$?([A-Z]{1,3})\$?([1-9][0-9]{0,6})$/;
+function parseCell(ref) {
+    const match = CELL.exec(ref);
+    if (!match)
+        return null;
+    const [, letters = '', digits = ''] = match;
+    let column = 0;
+    for (const ch of letters)
+        column = column * 26 + (ch.charCodeAt(0) - 64);
+    const row = Number(digits);
+    if (column > MAX_COLUMNS || row > MAX_ROWS)
+        return null;
+    return { row: row - 1, column: column - 1 };
+}
+export function parseA1Range(address) {
+    const parts = address.toUpperCase().split(':');
+    if (parts.length < 1 || parts.length > 2)
+        return null;
+    const start = parseCell(parts[0] ?? '');
+    const end = parts.length === 2 ? parseCell(parts[1] ?? '') : start;
+    if (!start || !end)
+        return null;
+    const row = Math.min(start.row, end.row);
+    const column = Math.min(start.column, end.column);
+    return {
+        row,
+        column,
+        rowCount: Math.abs(end.row - start.row) + 1,
+        columnCount: Math.abs(end.column - start.column) + 1,
+    };
+}
+export function columnName(index) {
+    let n = index + 1;
+    let name = '';
+    while (n > 0) {
+        const rem = (n - 1) % 26;
+        name = String.fromCharCode(65 + rem) + name;
+        n = Math.floor((n - 1) / 26);
+    }
+    return name;
+}
+export function formatA1Range(range) {
+    const start = `${columnName(range.column)}${range.row + 1}`;
+    if (range.rowCount === 1 && range.columnCount === 1)
+        return start;
+    const end = `${columnName(range.column + range.columnCount - 1)}${range.row + range.rowCount}`;
+    return `${start}:${end}`;
+}
+//# sourceMappingURL=a1.js.map

package/dist/a1.js.map

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

package/dist/api.d.ts

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+/** HTTP paths served by the backend. The task pane is served from the same origin. */
+export declare const API_PATHS: {
+    readonly health: "/healthz";
+    readonly ready: "/readyz";
+    readonly session: "/api/session";
+    /** Enrollment and limits for the signed-in user. */
+    readonly me: "/api/me";
+    /** Agents the signed-in user may address. */
+    readonly agents: "/api/agents";
+    readonly chat: "/api/chat";
+    /** `POST` with `:requestId` substituted. Closing the stream also cancels. */
+    readonly cancel: "/api/chat/:requestId/cancel";
+    readonly conversations: "/api/conversations";
+    /** `GET`, `PATCH` (rename) or `DELETE` with `:conversationId` substituted. */
+    readonly conversation: "/api/conversations/:conversationId";
+    /** `GET ?since=<seq>` replays a turn still in flight as an event stream. */
+    readonly conversationEvents: "/api/conversations/:conversationId/events";
+    /** `POST` multipart upload; `GET` with `:fileId` downloads. */
+    readonly files: "/api/files";
+    readonly file: "/api/files/:fileId";
+};
+export declare function cancelPath(requestId: string): string;
+export declare function conversationPath(conversationId: string): string;
+export declare function conversationEventsPath(conversationId: string, since?: number): string;
+export declare function filePath(fileId: string): string;
+export declare const HealthResponse: z.ZodObject<{
+    status: z.ZodLiteral<"ok">;
+}, z.core.$strip>;
+export type HealthResponse = z.infer<typeof HealthResponse>;
+export declare const ReadyResponse: z.ZodObject<{
+    status: z.ZodEnum<{
+        ready: "ready";
+        not_ready: "not_ready";
+    }>;
+    mode: z.ZodEnum<{
+        mock: "mock";
+        live: "live";
+    }>;
+    checks: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        ok: "ok";
+        fail: "fail";
+        skipped: "skipped";
+    }>>;
+}, z.core.$strip>;
+export type ReadyResponse = z.infer<typeof ReadyResponse>;
+export declare const SessionResponse: z.ZodObject<{
+    mode: z.ZodEnum<{
+        mock: "mock";
+        live: "live";
+    }>;
+    authenticated: z.ZodBoolean;
+    user: z.ZodNullable<z.ZodObject<{
+        subject: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionResponse = z.infer<typeof SessionResponse>;
+/** `GET /api/me`: whether this user may use the agent yet (pilot gating) and where else to go. */
+export declare const MeResponse: z.ZodObject<{
+    mode: z.ZodEnum<{
+        mock: "mock";
+        live: "live";
+    }>;
+    enabled: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodEnum<{
+        forbidden: "forbidden";
+        pilot_closed: "pilot_closed";
+    }>>;
+    user: z.ZodObject<{
+        subject: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type MeResponse = z.infer<typeof MeResponse>;
+export declare const AgentSummary: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentSummary = z.infer<typeof AgentSummary>;
+export declare const AgentsResponse: z.ZodObject<{
+    agents: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentsResponse = z.infer<typeof AgentsResponse>;
+export declare const ConversationSummary: z.ZodObject<{
+    conversationId: z.ZodString;
+    agent: z.ZodString;
+    title: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    activeRequestId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export type ConversationSummary = z.infer<typeof ConversationSummary>;
+export declare const ConversationListResponse: z.ZodObject<{
+    conversations: z.ZodArray<z.ZodObject<{
+        conversationId: z.ZodString;
+        agent: z.ZodString;
+        title: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        activeRequestId: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ConversationListResponse = z.infer<typeof ConversationListResponse>;
+export declare const ConversationRenameRequest: z.ZodObject<{
+    title: z.ZodString;
+}, z.core.$strip>;
+export type ConversationRenameRequest = z.infer<typeof ConversationRenameRequest>;
+export declare const FileRef: z.ZodObject<{
+    fileId: z.ZodString;
+    name: z.ZodString;
+    mimeType: z.ZodString;
+    bytes: z.ZodNumber;
+    status: z.ZodEnum<{
+        failed: "failed";
+        uploaded: "uploaded";
+        indexed: "indexed";
+    }>;
+}, z.core.$strip>;
+export type FileRef = z.infer<typeof FileRef>;
+export declare const FileUploadResponse: z.ZodObject<{
+    file: z.ZodObject<{
+        fileId: z.ZodString;
+        name: z.ZodString;
+        mimeType: z.ZodString;
+        bytes: z.ZodNumber;
+        status: z.ZodEnum<{
+            failed: "failed";
+            uploaded: "uploaded";
+            indexed: "indexed";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type FileUploadResponse = z.infer<typeof FileUploadResponse>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,sFAAsF;AACtF,eAAO,MAAM,SAAS;;;;IAIpB,oDAAoD;;IAEpD,6CAA6C;;;IAG7C,6EAA6E;;;IAG7E,8EAA8E;;IAE9E,4EAA4E;;IAE5E,+DAA+D;;;CAGvD,CAAC;AAEX,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AACD,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE/D;AACD,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMrF;AACD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,eAAO,MAAM,cAAc;;iBAAwC,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;iBAIxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe;;;;;;;;;;iBAK1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,kGAAkG;AAClG,eAAO,MAAM,UAAU;;;;;;;;;;;;;;iBAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,YAAY;;;;iBAIvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,eAAO,MAAM,cAAc;;;;;;iBAA8C,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;iBAQ9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAGnC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,eAAO,MAAM,yBAAyB;;iBAAyD,CAAC;AAChG,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF,eAAO,MAAM,OAAO;;;;;;;;;;iBAMlB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAC9C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAA8B,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/api.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { BackendMode } from './events.js';
+import { AgentKey, ConversationId, FileId } from './ids.js';
+/** HTTP paths served by the backend. The task pane is served from the same origin. */
+export const API_PATHS = {
+    health: '/healthz',
+    ready: '/readyz',
+    session: '/api/session',
+    /** Enrollment and limits for the signed-in user. */
+    me: '/api/me',
+    /** Agents the signed-in user may address. */
+    agents: '/api/agents',
+    chat: '/api/chat',
+    /** `POST` with `:requestId` substituted. Closing the stream also cancels. */
+    cancel: '/api/chat/:requestId/cancel',
+    conversations: '/api/conversations',
+    /** `GET`, `PATCH` (rename) or `DELETE` with `:conversationId` substituted. */
+    conversation: '/api/conversations/:conversationId',
+    /** `GET ?since=<seq>` replays a turn still in flight as an event stream. */
+    conversationEvents: '/api/conversations/:conversationId/events',
+    /** `POST` multipart upload; `GET` with `:fileId` downloads. */
+    files: '/api/files',
+    file: '/api/files/:fileId',
+};
+export function cancelPath(requestId) {
+    return API_PATHS.cancel.replace(':requestId', encodeURIComponent(requestId));
+}
+export function conversationPath(conversationId) {
+    return API_PATHS.conversation.replace(':conversationId', encodeURIComponent(conversationId));
+}
+export function conversationEventsPath(conversationId, since) {
+    const base = API_PATHS.conversationEvents.replace(':conversationId', encodeURIComponent(conversationId));
+    return since === undefined ? base : `${base}?since=${since}`;
+}
+export function filePath(fileId) {
+    return API_PATHS.file.replace(':fileId', encodeURIComponent(fileId));
+}
+export const HealthResponse = z.object({ status: z.literal('ok') });
+export const ReadyResponse = z.object({
+    status: z.enum(['ready', 'not_ready']),
+    mode: BackendMode,
+    checks: z.record(z.string(), z.enum(['ok', 'fail', 'skipped'])),
+});
+export const SessionResponse = z.object({
+    mode: BackendMode,
+    authenticated: z.boolean(),
+    /** Display-only identity; never a token. */
+    user: z.object({ subject: z.string(), name: z.string().optional() }).nullable(),
+});
+/** `GET /api/me`: whether this user may use the agent yet (pilot gating) and where else to go. */
+export const MeResponse = z.object({
+    mode: BackendMode,
+    enabled: z.boolean(),
+    reason: z.enum(['pilot_closed', 'forbidden']).optional(),
+    /** Display-only identity; never a token. */
+    user: z.object({ subject: z.string(), name: z.string().optional() }),
+});
+export const AgentSummary = z.object({
+    key: AgentKey,
+    name: z.string().min(1).max(100),
+    description: z.string().max(1_000).optional(),
+});
+export const AgentsResponse = z.object({ agents: z.array(AgentSummary) });
+export const ConversationSummary = z.object({
+    conversationId: ConversationId,
+    agent: AgentKey,
+    title: z.string().max(200),
+    createdAt: z.iso.datetime(),
+    updatedAt: z.iso.datetime(),
+    /** Set while a turn is still running, so a client can resume its stream. */
+    activeRequestId: z.uuid().optional(),
+});
+export const ConversationListResponse = z.object({
+    conversations: z.array(ConversationSummary),
+    nextCursor: z.string().max(200).optional(),
+});
+export const ConversationRenameRequest = z.object({ title: z.string().trim().min(1).max(200) });
+export const FileRef = z.object({
+    fileId: FileId,
+    name: z.string().min(1).max(255),
+    mimeType: z.string().min(1).max(127),
+    bytes: z.number().int().nonnegative(),
+    status: z.enum(['uploaded', 'indexed', 'failed']),
+});
+export const FileUploadResponse = z.object({ file: FileRef });
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+/**
+ * Sign-in handoff between the task pane, the Office dialog and the gateway
+ * (docs/architecture/auth-design.md). All paths are on the pane's own origin.
+ *
+ * 1. The pane creates a random `verifier` and opens the Office dialog at
+ *    `/auth/start?challenge=<base64url(sha256(verifier))>`.
+ * 2. After the identity provider redirect, the gateway's `/auth/callback` page sends ONE
+ *    `AuthDialogMessage` (JSON string) to the pane with `Office.context.ui.messageParent`.
+ * 3. The pane checks the message origin and shape, closes the dialog, and redeems the
+ *    single-use handoff code with `POST /auth/exchange` (`AuthExchangeRequest`).
+ * 4. The gateway answers `AuthExchangeResponse` and also sets an HttpOnly session cookie.
+ *    The pane sends the session token as `Authorization: Bearer`; provider tokens never
+ *    reach the pane.
+ */
+export declare const AUTH_PATHS: {
+    /** `GET ?challenge=`: opened in the Office dialog; redirects to the identity provider. */
+    readonly start: "/auth/start";
+    /** `GET`: identity provider redirect target; renders the handoff page. */
+    readonly callback: "/auth/callback";
+    /** `POST AuthExchangeRequest` → `AuthExchangeResponse`. */
+    readonly exchange: "/auth/exchange";
+    /** `POST`: ends the gateway session (not the identity provider session). 204. */
+    readonly logout: "/auth/logout";
+};
+export declare const AUTH_MESSAGE_TYPE = "classic-agent-auth";
+/** Pane-only secret: 43-128 RFC 7636 unreserved characters. */
+export declare const PaneVerifier: z.ZodString;
+/** `base64url(sha256(verifier))` without padding. */
+export declare const PaneChallenge: z.ZodString;
+/** Single-use, short-lived handoff code (base64url). */
+export declare const HandoffCode: z.ZodString;
+export declare function authStartPath(challenge: string): string;
+/** The one message the callback page sends to the pane (serialized as JSON). */
+export declare const AuthDialogMessage: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"classic-agent-auth">;
+    status: z.ZodLiteral<"ok">;
+    handoffCode: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"classic-agent-auth">;
+    status: z.ZodLiteral<"error">;
+    error: z.ZodString;
+}, z.core.$strict>], "status">;
+export type AuthDialogMessage = z.infer<typeof AuthDialogMessage>;
+export declare const AuthExchangeRequest: z.ZodObject<{
+    handoffCode: z.ZodString;
+    verifier: z.ZodString;
+}, z.core.$strict>;
+export type AuthExchangeRequest = z.infer<typeof AuthExchangeRequest>;
+export declare const AuthExchangeResponse: z.ZodObject<{
+    sessionToken: z.ZodString;
+    expiresAt: z.ZodISODateTime;
+    user: z.ZodObject<{
+        subject: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AuthExchangeResponse = z.infer<typeof AuthExchangeResponse>;
+/**
+ * Device-flow sign-in (native runtime). The pane starts a login, shows the user code and the
+ * verification link, then polls until the identity provider confirms. The redeemed session is
+ * the same opaque bearer as above; provider tokens never reach the pane.
+ */
+export declare const DEVICE_AUTH_PATHS: {
+    /** `POST` → `DeviceStartResponse`. */
+    readonly start: "/auth/device/start";
+    /** `POST DevicePollRequest` → `DevicePollResponse`. */
+    readonly poll: "/auth/device/poll";
+};
+export declare const DeviceStartResponse: z.ZodObject<{
+    loginId: z.ZodString;
+    userCode: z.ZodString;
+    verificationUri: z.ZodURL;
+    verificationUriComplete: z.ZodOptional<z.ZodURL>;
+    expiresIn: z.ZodNumber;
+    interval: z.ZodNumber;
+}, z.core.$strip>;
+export type DeviceStartResponse = z.infer<typeof DeviceStartResponse>;
+export declare const DevicePollRequest: z.ZodObject<{
+    loginId: z.ZodString;
+}, z.core.$strip>;
+export type DevicePollRequest = z.infer<typeof DevicePollRequest>;
+export declare const DevicePollResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"pending">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"slow_down">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"expired">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"denied">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"authorized">;
+    sessionToken: z.ZodString;
+    expiresIn: z.ZodNumber;
+    user: z.ZodObject<{
+        subject: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "status">;
+export type DevicePollResponse = z.infer<typeof DevicePollResponse>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,UAAU;IACrB,0FAA0F;;IAE1F,0EAA0E;;IAE1E,2DAA2D;;IAE3D,iFAAiF;;CAEzE,CAAC;AAEX,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD,+DAA+D;AAC/D,eAAO,MAAM,YAAY,aAAgD,CAAC;AAC1E,qDAAqD;AACrD,eAAO,MAAM,aAAa,aAA0C,CAAC;AACrE,wDAAwD;AACxD,eAAO,MAAM,WAAW,aAII,CAAC;AAE7B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,gFAAgF;AAChF,eAAO,MAAM,iBAAiB;;;;;;;;8BAe5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB;;;kBAErB,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,sCAAsC;;IAEtC,uDAAuD;;CAE/C,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;iBAS9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,iBAAiB;;iBAAqD,CAAC;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;6BAW7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/auth.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+/**
+ * Sign-in handoff between the task pane, the Office dialog and the gateway
+ * (docs/architecture/auth-design.md). All paths are on the pane's own origin.
+ *
+ * 1. The pane creates a random `verifier` and opens the Office dialog at
+ *    `/auth/start?challenge=<base64url(sha256(verifier))>`.
+ * 2. After the identity provider redirect, the gateway's `/auth/callback` page sends ONE
+ *    `AuthDialogMessage` (JSON string) to the pane with `Office.context.ui.messageParent`.
+ * 3. The pane checks the message origin and shape, closes the dialog, and redeems the
+ *    single-use handoff code with `POST /auth/exchange` (`AuthExchangeRequest`).
+ * 4. The gateway answers `AuthExchangeResponse` and also sets an HttpOnly session cookie.
+ *    The pane sends the session token as `Authorization: Bearer`; provider tokens never
+ *    reach the pane.
+ */
+export const AUTH_PATHS = {
+    /** `GET ?challenge=`: opened in the Office dialog; redirects to the identity provider. */
+    start: '/auth/start',
+    /** `GET`: identity provider redirect target; renders the handoff page. */
+    callback: '/auth/callback',
+    /** `POST AuthExchangeRequest` → `AuthExchangeResponse`. */
+    exchange: '/auth/exchange',
+    /** `POST`: ends the gateway session (not the identity provider session). 204. */
+    logout: '/auth/logout',
+};
+export const AUTH_MESSAGE_TYPE = 'classic-agent-auth';
+/** Pane-only secret: 43-128 RFC 7636 unreserved characters. */
+export const PaneVerifier = z.string().regex(/^[A-Za-z0-9._~-]{43,128}$/);
+/** `base64url(sha256(verifier))` without padding. */
+export const PaneChallenge = z.string().regex(/^[A-Za-z0-9_-]{43}$/);
+/** Single-use, short-lived handoff code (base64url). */
+export const HandoffCode = z
+    .string()
+    .min(16)
+    .max(512)
+    .regex(/^[A-Za-z0-9_-]+$/);
+export function authStartPath(challenge) {
+    return `${AUTH_PATHS.start}?challenge=${encodeURIComponent(challenge)}`;
+}
+/** The one message the callback page sends to the pane (serialized as JSON). */
+export const AuthDialogMessage = z.discriminatedUnion('status', [
+    z
+        .object({
+        type: z.literal(AUTH_MESSAGE_TYPE),
+        status: z.literal('ok'),
+        handoffCode: HandoffCode,
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal(AUTH_MESSAGE_TYPE),
+        status: z.literal('error'),
+        error: z.string().min(1).max(500),
+    })
+        .strict(),
+]);
+export const AuthExchangeRequest = z
+    .object({ handoffCode: HandoffCode, verifier: PaneVerifier })
+    .strict();
+export const AuthExchangeResponse = z.object({
+    /** Opaque gateway session credential. Keep in memory; never in localStorage. */
+    sessionToken: z.string().min(16).max(512),
+    expiresAt: z.iso.datetime(),
+    /** Display-only identity. */
+    user: z.object({ subject: z.string(), name: z.string().optional() }),
+});
+/**
+ * Device-flow sign-in (native runtime). The pane starts a login, shows the user code and the
+ * verification link, then polls until the identity provider confirms. The redeemed session is
+ * the same opaque bearer as above; provider tokens never reach the pane.
+ */
+export const DEVICE_AUTH_PATHS = {
+    /** `POST` → `DeviceStartResponse`. */
+    start: '/auth/device/start',
+    /** `POST DevicePollRequest` → `DevicePollResponse`. */
+    poll: '/auth/device/poll',
+};
+export const DeviceStartResponse = z.object({
+    loginId: z.string().min(16).max(128),
+    userCode: z.string().min(1).max(32),
+    verificationUri: z.url(),
+    verificationUriComplete: z.url().optional(),
+    /** Seconds until the login must be completed. */
+    expiresIn: z.number().int().positive(),
+    /** Minimum seconds between polls. */
+    interval: z.number().int().positive(),
+});
+export const DevicePollRequest = z.object({ loginId: z.string().min(16).max(128) });
+export const DevicePollResponse = z.discriminatedUnion('status', [
+    z.object({ status: z.literal('pending') }),
+    z.object({ status: z.literal('slow_down') }),
+    z.object({ status: z.literal('expired') }),
+    z.object({ status: z.literal('denied') }),
+    z.object({
+        status: z.literal('authorized'),
+        sessionToken: z.string().min(16),
+        expiresIn: z.number().int().positive(),
+        user: z.object({ subject: z.string(), name: z.string().optional() }),
+    }),
+]);
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/chat.d.ts

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+/** Which client sent a request. Lets the backend shape tool availability and rendering hints. */
+export declare const ClientKind: z.ZodEnum<{
+    app: "app";
+    office: "office";
+}>;
+export type ClientKind = z.infer<typeof ClientKind>;
+/** Body of `POST /api/chat`. */
+export declare const ChatRequest: z.ZodObject<{
+    requestId: z.ZodUUID;
+    conversationId: z.ZodOptional<z.ZodString>;
+    agent: z.ZodDefault<z.ZodString>;
+    message: z.ZodString;
+    context: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        selection: z.ZodObject<{
+            sheet: z.ZodString;
+            address: z.ZodString;
+            values: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+            formulas: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        }, z.core.$strip>;
+        documentId: z.ZodString;
+        capturedAt: z.ZodISODateTime;
+        simulated: z.ZodBoolean;
+        host: z.ZodLiteral<"excel">;
+    }, z.core.$strip>, z.ZodObject<{
+        selection: z.ZodObject<{
+            text: z.ZodString;
+            isEmpty: z.ZodBoolean;
+            target: z.ZodObject<{
+                targetId: z.ZodString;
+                expectedText: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        documentId: z.ZodString;
+        capturedAt: z.ZodISODateTime;
+        simulated: z.ZodBoolean;
+        host: z.ZodLiteral<"word">;
+    }, z.core.$strip>, z.ZodObject<{
+        host: z.ZodLiteral<"app">;
+        capturedAt: z.ZodISODateTime;
+        route: z.ZodString;
+        title: z.ZodString;
+        tab: z.ZodOptional<z.ZodString>;
+        record: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                home: "home";
+                lot: "lot";
+                community: "community";
+                filing: "filing";
+                floorplan: "floorplan";
+                elevation: "elevation";
+                district: "district";
+                user: "user";
+                vendor: "vendor";
+                sign: "sign";
+                "slide-deck": "slide-deck";
+                survey: "survey";
+                workspace: "workspace";
+                walk: "walk";
+                permit: "permit";
+                incentive: "incentive";
+            }>;
+            id: z.ZodString;
+            label: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        target: z.ZodOptional<z.ZodObject<{
+            homeRid: z.ZodOptional<z.ZodNumber>;
+            lotRid: z.ZodOptional<z.ZodNumber>;
+            elevationRid: z.ZodOptional<z.ZodNumber>;
+            floorplanRid: z.ZodOptional<z.ZodNumber>;
+            filingRid: z.ZodOptional<z.ZodNumber>;
+            communityRid: z.ZodOptional<z.ZodNumber>;
+            districtId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        facts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        selection: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "host">>;
+    operationResults: z.ZodOptional<z.ZodArray<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>>>;
+    fileIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    client: z.ZodOptional<z.ZodEnum<{
+        app: "app";
+        office: "office";
+    }>>;
+}, z.core.$strip>;
+export type ChatRequest = z.infer<typeof ChatRequest>;
+export type ChatRequestInput = z.input<typeof ChatRequest>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,iGAAiG;AACjG,eAAO,MAAM,UAAU;;;EAA4B,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,gCAAgC;AAChC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}