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

package/dist/client.d.ts

@@ -0,0 +1,70 @@
+import { AgentsResponse, AuthExchangeResponse, ConversationListResponse, DevicePollResponse, DeviceStartResponse, MeResponse, SessionResponse, type AuthExchangeRequest, type ChatEvent, type ChatRequest, type FileRef } from '@classic-homes/agent-contracts';
+import { type StreamOutcome } from './stream.js';
+export interface AgentApiClientOptions {
+    /** Origin of the API; empty for same-origin (the Office pane). No trailing slash. */
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    /**
+     * Supplies the bearer for each request (the Classic App passes its CHAPI token here). When
+     * absent, the client sends the in-memory session token obtained from sign-in.
+     */
+    getToken?: () => Promise<string | undefined> | string | undefined;
+    /** Default `same-origin`; the Classic App uses `omit` (bearer only, no cookies). */
+    credentials?: 'omit' | 'same-origin' | 'include';
+}
+export interface ConversationDetail {
+    conversation: ConversationListResponse['conversations'][number];
+    messages: Array<{
+        id: string;
+        seq: number;
+        role: 'user' | 'assistant';
+        agent?: string;
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        createdAt: number;
+    }>;
+    files: FileRef[];
+}
+export interface AgentApiClient {
+    getSession(): Promise<SessionResponse>;
+    getMe(): Promise<MeResponse>;
+    listAgents(): Promise<AgentsResponse>;
+    streamChat(request: ChatRequest, options: {
+        signal: AbortSignal;
+        onEvent: (event: ChatEvent) => void;
+    }): Promise<StreamOutcome>;
+    /** Re-attach to a turn still running (or recently finished), replaying events after `since`. */
+    resumeTurn(conversationId: string, requestId: string, since: number, options: {
+        signal: AbortSignal;
+        onEvent: (event: ChatEvent) => void;
+    }): Promise<StreamOutcome>;
+    /** Best-effort server-side cancel; aborting the stream also cancels. */
+    cancel(requestId: string): Promise<void>;
+    listConversations(params?: {
+        cursor?: string;
+        q?: string;
+        limit?: number;
+    }): Promise<ConversationListResponse>;
+    getConversation(conversationId: string): Promise<ConversationDetail>;
+    renameConversation(conversationId: string, title: string): Promise<void>;
+    deleteConversation(conversationId: string): Promise<void>;
+    uploadFile(file: Blob, name: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<FileRef>;
+    /** Absolute or same-origin URL to download a file; requires the bearer, so prefer `fetch` + blob for display. */
+    fileUrl(fileId: string): string;
+    /** Office sign-in: redeem a single-use handoff code (dialog flow). */
+    exchangeHandoff(request: AuthExchangeRequest): Promise<AuthExchangeResponse>;
+    /** Office sign-in: device flow. `devicePoll` stores the session token when authorized. */
+    deviceStart(): Promise<DeviceStartResponse>;
+    devicePoll(loginId: string): Promise<DevicePollResponse>;
+    /** End the session and forget the in-memory token. */
+    logout(): Promise<void>;
+    hasSessionToken(): boolean;
+    /** Called after a request was refused with 401 (the in-memory token is already cleared). */
+    onUnauthenticated(listener: () => void): () => void;
+}
+export declare function createAgentApiClient(options?: AgentApiClientOptions): AgentApiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,156 @@
+import { AgentsResponse, API_PATHS, AUTH_PATHS, AuthExchangeResponse, ConversationListResponse, DEVICE_AUTH_PATHS, DevicePollResponse, DeviceStartResponse, FileUploadResponse, MeResponse, SessionResponse, cancelPath, conversationEventsPath, conversationPath, filePath, } from '@classic-homes/agent-contracts';
+import { ApiRequestError, errorFromResponse, isAbort } from './errors.js';
+import { readChatStream } from './stream.js';
+export function createAgentApiClient(options = {}) {
+    const fetchImpl = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+    const baseUrl = (options.baseUrl ?? '').replace(/\/$/, '');
+    const credentials = options.credentials ?? 'same-origin';
+    /** Session bearer, memory only: lost on reload, never written to storage. */
+    let sessionToken;
+    const unauthenticatedListeners = new Set();
+    async function bearer() {
+        if (options.getToken)
+            return (await options.getToken()) ?? undefined;
+        return sessionToken;
+    }
+    async function request(path, init) {
+        const headers = new Headers(init?.headers);
+        const token = await bearer();
+        if (token)
+            headers.set('Authorization', `Bearer ${token}`);
+        let response;
+        try {
+            response = await fetchImpl(`${baseUrl}${path}`, { ...init, credentials, headers });
+        }
+        catch (error) {
+            if (isAbort(error, init?.signal ?? undefined))
+                throw error;
+            throw new ApiRequestError('network', 'Cannot reach the Classic Agent backend.');
+        }
+        if (response.status === 401 && path.startsWith('/api/')) {
+            sessionToken = undefined;
+            for (const listener of [...unauthenticatedListeners])
+                listener();
+        }
+        return response;
+    }
+    async function json(path, schema, init) {
+        const response = await request(path, init);
+        if (!response.ok)
+            throw await errorFromResponse(response);
+        try {
+            return schema.parse(await response.json());
+        }
+        catch {
+            throw new ApiRequestError('protocol', `Unexpected response from ${path}.`, response.status);
+        }
+    }
+    async function stream(path, init, requestId, since, streamOptions) {
+        let response;
+        try {
+            response = await request(path, {
+                ...init,
+                headers: { ...init.headers, Accept: 'text/event-stream' },
+                signal: streamOptions.signal,
+            });
+        }
+        catch (error) {
+            if (isAbort(error, streamOptions.signal))
+                return { kind: 'aborted' };
+            throw error;
+        }
+        if (!response.ok)
+            throw await errorFromResponse(response);
+        return readChatStream(response, { ...streamOptions, requestId, since });
+    }
+    const JSON_HEADERS = { 'Content-Type': 'application/json', Accept: 'application/json' };
+    const ACCEPT_JSON = { Accept: 'application/json' };
+    return {
+        getSession: () => json(API_PATHS.session, SessionResponse, { headers: ACCEPT_JSON }),
+        getMe: () => json(API_PATHS.me, MeResponse, { headers: ACCEPT_JSON }),
+        listAgents: () => json(API_PATHS.agents, AgentsResponse, { headers: ACCEPT_JSON }),
+        streamChat: (chatRequest, streamOptions) => stream(API_PATHS.chat, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(chatRequest),
+        }, chatRequest.requestId, undefined, streamOptions),
+        resumeTurn: (conversationId, requestId, since, streamOptions) => stream(`${conversationEventsPath(conversationId, since)}&requestId=${encodeURIComponent(requestId)}`, { method: 'GET' }, requestId, since, streamOptions),
+        async cancel(requestId) {
+            try {
+                await request(cancelPath(requestId), { method: 'POST' });
+            }
+            catch {
+                // Best effort: the aborted stream also cancels upstream.
+            }
+        },
+        listConversations(params = {}) {
+            const query = new URLSearchParams();
+            if (params.cursor)
+                query.set('cursor', params.cursor);
+            if (params.q)
+                query.set('q', params.q);
+            if (params.limit)
+                query.set('limit', String(params.limit));
+            const suffix = query.size ? `?${query}` : '';
+            return json(`${API_PATHS.conversations}${suffix}`, ConversationListResponse, {
+                headers: ACCEPT_JSON,
+            });
+        },
+        getConversation: (conversationId) => json(conversationPath(conversationId), { parse: (v) => v }, { headers: ACCEPT_JSON }),
+        async renameConversation(conversationId, title) {
+            await json(conversationPath(conversationId), { parse: (v) => v }, { method: 'PATCH', headers: JSON_HEADERS, body: JSON.stringify({ title }) });
+        },
+        async deleteConversation(conversationId) {
+            const response = await request(conversationPath(conversationId), { method: 'DELETE' });
+            if (!response.ok)
+                throw await errorFromResponse(response);
+        },
+        async uploadFile(file, name, uploadOptions = {}) {
+            const form = new FormData();
+            form.append('file', file, name);
+            const result = await json(API_PATHS.files, FileUploadResponse, {
+                method: 'POST',
+                body: form,
+                signal: uploadOptions.signal ?? null,
+            });
+            return result.file;
+        },
+        fileUrl: (fileId) => `${baseUrl}${filePath(fileId)}`,
+        async exchangeHandoff(exchange) {
+            const result = await json(AUTH_PATHS.exchange, AuthExchangeResponse, {
+                method: 'POST',
+                headers: JSON_HEADERS,
+                body: JSON.stringify(exchange),
+            });
+            sessionToken = result.sessionToken;
+            return result;
+        },
+        deviceStart: () => json(DEVICE_AUTH_PATHS.start, DeviceStartResponse, { method: 'POST', headers: ACCEPT_JSON }),
+        async devicePoll(loginId) {
+            const result = await json(DEVICE_AUTH_PATHS.poll, DevicePollResponse, {
+                method: 'POST',
+                headers: JSON_HEADERS,
+                body: JSON.stringify({ loginId }),
+            });
+            if (result.status === 'authorized')
+                sessionToken = result.sessionToken;
+            return result;
+        },
+        async logout() {
+            try {
+                const response = await request(AUTH_PATHS.logout, { method: 'POST' });
+                if (!response.ok)
+                    throw await errorFromResponse(response);
+            }
+            finally {
+                sessionToken = undefined;
+            }
+        },
+        hasSessionToken: () => sessionToken !== undefined,
+        onUnauthenticated(listener) {
+            unauthenticatedListeners.add(listener);
+            return () => unauthenticatedListeners.delete(listener);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+import { type ErrorCode } from '@classic-homes/agent-contracts';
+/** Failure codes a client can show: contract error codes plus transport problems. */
+export type ClientErrorCode = ErrorCode | 'network' | 'protocol';
+export declare class ApiRequestError extends Error {
+    readonly code: ClientErrorCode;
+    readonly status: number | undefined;
+    readonly retryable: boolean;
+    constructor(code: ClientErrorCode, message: string, status?: number);
+}
+export declare function errorFromResponse(response: Response): Promise<ApiRequestError>;
+export declare function isAbort(error: unknown, signal?: AbortSignal): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE1E,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAChB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOpE;AAcD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBpF;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAErE"}

package/dist/errors.js

@@ -0,0 +1,47 @@
+import { ApiError } from '@classic-homes/agent-contracts';
+export class ApiRequestError extends Error {
+    code;
+    status;
+    retryable;
+    constructor(code, message, status) {
+        super(message);
+        this.name = 'ApiRequestError';
+        this.code = code;
+        this.status = status;
+        this.retryable = ['network', 'rate_limited', 'upstream_unavailable', 'timeout'].includes(code);
+    }
+}
+const STATUS_CODES = {
+    400: 'bad_request',
+    401: 'unauthenticated',
+    403: 'forbidden',
+    404: 'not_found',
+    413: 'message_too_large',
+    429: 'rate_limited',
+    502: 'upstream_unavailable',
+    503: 'upstream_unavailable',
+    504: 'timeout',
+};
+export async function errorFromResponse(response) {
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        body = undefined;
+    }
+    const parsed = ApiError.safeParse(body);
+    if (parsed.success) {
+        return new ApiRequestError(parsed.data.error.code, parsed.data.error.message, response.status);
+    }
+    // No contract body: most likely a proxy could not reach the backend.
+    if (response.status >= 500 && response.status !== 503 && response.status !== 504) {
+        return new ApiRequestError('network', `The Classic Agent backend is unavailable (HTTP ${response.status}).`, response.status);
+    }
+    const code = STATUS_CODES[response.status] ?? 'internal';
+    return new ApiRequestError(code, `Request failed with HTTP ${response.status}.`, response.status);
+}
+export function isAbort(error, signal) {
+    return !!signal?.aborted || (error instanceof DOMException && error.name === 'AbortError');
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,gCAAgC,CAAC;AAK1E,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAkB;IACtB,MAAM,CAAqB;IAC3B,SAAS,CAAU;IAC5B,YAAY,IAAqB,EAAE,OAAe,EAAE,MAAe;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjG,CAAC;CACF;AAED,MAAM,YAAY,GAA8B;IAC9C,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACxD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjG,CAAC;IACD,qEAAqE;IACrE,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACjF,OAAO,IAAI,eAAe,CACxB,SAAS,EACT,kDAAkD,QAAQ,CAAC,MAAM,IAAI,EACrE,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC;IACzD,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE,4BAA4B,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,MAAoB;IAC1D,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;AAC7F,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './client.js';
+export * from './errors.js';
+export * from './stream.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,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './client.js';
+export * from './errors.js';
+export * from './stream.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,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,27 @@
+import { type ChatEvent, type DoneEvent } from '@classic-homes/agent-contracts';
+export type StreamOutcome = {
+    kind: 'done';
+    event: DoneEvent;
+}
+/** The connection closed before a `done` event (possibly mid-frame). */
+ | {
+    kind: 'ended';
+    partialFrame: boolean;
+} | {
+    kind: 'aborted';
+};
+export interface StreamOptions {
+    signal: AbortSignal;
+    onEvent: (event: ChatEvent) => void;
+    /** The request id every event must carry. */
+    requestId: string;
+    /** When resuming, the last `seq` already seen; events at or below it are rejected. */
+    since?: number;
+}
+/**
+ * Read an event stream and enforce the contract: one request id, a leading `start` (unless
+ * resuming), strictly increasing `seq`, and a single `done`. Unknown event types keep the
+ * ordering checks and are otherwise ignored.
+ */
+export declare function readChatStream(response: Response, options: StreamOptions): Promise<StreamOutcome>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,gCAAgC,CAAC;AAGxC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AACpC,wEAAwE;GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAwDxB"}

package/dist/stream.js

@@ -0,0 +1,69 @@
+import { SseDecoder, isKnownEvent, } from '@classic-homes/agent-contracts';
+import { ApiRequestError, isAbort } from './errors.js';
+/**
+ * Read an event stream and enforce the contract: one request id, a leading `start` (unless
+ * resuming), strictly increasing `seq`, and a single `done`. Unknown event types keep the
+ * ordering checks and are otherwise ignored.
+ */
+export async function readChatStream(response, options) {
+    const { signal, onEvent } = options;
+    const type = response.headers.get('content-type') ?? '';
+    if (!type.includes('text/event-stream') || !response.body) {
+        throw new ApiRequestError('protocol', 'The backend did not return an event stream.');
+    }
+    const reader = response.body.getReader();
+    const text = new TextDecoder();
+    const decoder = new SseDecoder();
+    let lastSeq = options.since ?? -1;
+    const resuming = options.since !== undefined;
+    const accept = (events) => {
+        for (const event of events) {
+            if (event.requestId !== options.requestId) {
+                throw new ApiRequestError('protocol', 'The stream belongs to a different request.');
+            }
+            if (!resuming && lastSeq === -1 && event.type !== 'start') {
+                throw new ApiRequestError('protocol', 'The stream did not begin with a start event.');
+            }
+            if (event.seq <= lastSeq) {
+                throw new ApiRequestError('protocol', 'The stream events arrived out of order.');
+            }
+            lastSeq = event.seq;
+            if (!isKnownEvent(event))
+                continue;
+            onEvent(event);
+            if (event.type === 'done')
+                return event;
+        }
+        return undefined;
+    };
+    try {
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            let events;
+            try {
+                events = decoder.push(text.decode(value, { stream: true }));
+            }
+            catch {
+                throw new ApiRequestError('protocol', 'The backend sent an invalid stream event.');
+            }
+            const finished = accept(events);
+            if (finished) {
+                void reader.cancel().catch(() => { });
+                return { kind: 'done', event: finished };
+            }
+        }
+    }
+    catch (error) {
+        if (isAbort(error, signal))
+            return { kind: 'aborted' };
+        if (error instanceof ApiRequestError) {
+            void reader.cancel().catch(() => { });
+            throw error;
+        }
+        return { kind: 'ended', partialFrame: decoder.pending };
+    }
+    return { kind: 'ended', partialFrame: decoder.pending };
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@classic-homes/agent-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "Framework-free client for the Classic Agent API: sessions, streaming chat with ordering checks, conversations and files. Shared by the Office task pane and the Classic App.",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@classic-homes/agent-contracts": "0.1.1"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Classic-Homes/classic-agent.git",
+    "directory": "packages/agent-client"
+  },
+  "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.