@pantheon-systems/css-client 0.4.0

package/dist/content.d.ts

@@ -0,0 +1,45 @@
+/**
+ * P1 Content Client
+ *
+ * Read-only client for fetching published content from the P1 content delivery API.
+ * Designed for server-side use (e.g., Next.js SSR/SSG) without pulling in
+ * browser dependencies like partysocket.
+ */
+export interface P1ContentClientConfig {
+    baseUrl: string;
+    apiToken: string;
+    siteId: string;
+    branchId?: string;
+}
+export interface PageContent {
+    documentId: string;
+    path: string;
+    data: Record<string, unknown>;
+    branchId: string;
+    branchName: string;
+    isMainBranch: boolean;
+    versionNumber: number;
+    versionCreatedAt: string;
+    etag: string;
+}
+export interface PageListEntry {
+    path: string;
+    documentId: string;
+    lastModifiedAt: string;
+}
+export interface PageListResult {
+    pages: PageListEntry[];
+    branchId: string;
+    branchName: string;
+    isMainBranch: boolean;
+}
+export declare class P1ContentClient {
+    private baseUrl;
+    private apiToken;
+    private siteId;
+    private branchId?;
+    constructor(config: P1ContentClientConfig);
+    getPage(documentPath: string): Promise<PageContent | null>;
+    getPagePaths(): Promise<PageListResult>;
+}
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAcD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,MAAM,EAAE,qBAAqB;IAOnC,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAsB1D,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;CAiB9C"}

package/dist/content.js

@@ -0,0 +1,65 @@
+/**
+ * P1 Content Client
+ *
+ * Read-only client for fetching published content from the P1 content delivery API.
+ * Designed for server-side use (e.g., Next.js SSR/SSG) without pulling in
+ * browser dependencies like partysocket.
+ */
+import { P1ApiError } from './errors.js';
+function trimTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '/')
+        end--;
+    return value.slice(0, end);
+}
+function trimLeadingSlashes(value) {
+    let start = 0;
+    while (start < value.length && value[start] === '/')
+        start++;
+    return value.slice(start);
+}
+export class P1ContentClient {
+    baseUrl;
+    apiToken;
+    siteId;
+    branchId;
+    constructor(config) {
+        this.baseUrl = trimTrailingSlashes(config.baseUrl);
+        this.apiToken = config.apiToken;
+        this.siteId = config.siteId;
+        this.branchId = config.branchId;
+    }
+    async getPage(documentPath) {
+        const cleanPath = trimLeadingSlashes(documentPath);
+        let url = `${this.baseUrl}/api/sites/${this.siteId}/content/${cleanPath}`;
+        if (this.branchId) {
+            url += `?branch=${this.branchId}`;
+        }
+        const response = await fetch(url, {
+            headers: { 'X-API-Key': this.apiToken },
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            throw new P1ApiError(body.error || `HTTP ${response.status}`, response.status);
+        }
+        return response.json();
+    }
+    async getPagePaths() {
+        let url = `${this.baseUrl}/api/sites/${this.siteId}/content-pages`;
+        if (this.branchId) {
+            url += `?branch=${this.branchId}`;
+        }
+        const response = await fetch(url, {
+            headers: { 'X-API-Key': this.apiToken },
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            throw new P1ApiError(body.error || `HTTP ${response.status}`, response.status);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

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

package/dist/endpoints/agent-edit.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Agent Edit Endpoint
+ *
+ * API endpoints for the agent edit workflow (politeness protocol).
+ */
+import type { BaseEndpoint } from './base.js';
+import type { AgentEditContext, AgentEditPermission, AgentEditSession, AgentEditCompleteResult, AgentEditAbortResult, AgentStopResult } from '../types.js';
+/**
+ * Agent edit endpoint for managing agent edit sessions.
+ */
+export declare class AgentEditEndpoint {
+    private readonly base;
+    constructor(base: BaseEndpoint);
+    /**
+     * Encode document path for URL.
+     * Document paths start with / which needs proper encoding.
+     */
+    private encodeDocumentPath;
+    /**
+     * Check if an agent can edit a document.
+     *
+     * Returns whether the agent can proceed and, if not, the reason why.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path (e.g., "/home")
+     * @param context - Agent edit context (agentId, trigger, intent, targetRegions)
+     */
+    canEdit(siteId: string, branchId: string, documentPath: string, context: AgentEditContext): Promise<AgentEditPermission>;
+    /**
+     * Start an agent edit session.
+     *
+     * Reserves the edit session, sets focus regions, and optionally creates
+     * a checkpoint for autonomous edits.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param context - Agent edit context
+     */
+    startEdit(siteId: string, branchId: string, documentPath: string, context: AgentEditContext): Promise<AgentEditSession>;
+    /**
+     * Complete an agent edit session.
+     *
+     * Clears focus regions and updates checkpoint status.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param agentId - Agent ID
+     */
+    completeEdit(siteId: string, branchId: string, documentPath: string, agentId: string): Promise<AgentEditCompleteResult>;
+    /**
+     * Abort an agent edit session.
+     *
+     * Rolls back to the checkpoint created at edit-start.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param agentId - Agent ID
+     * @param checkpointId - Checkpoint to rollback to
+     */
+    abortEdit(siteId: string, branchId: string, documentPath: string, agentId: string, checkpointId: string): Promise<AgentEditAbortResult>;
+    /**
+     * Stop an agent's edit session (human-initiated).
+     *
+     * Server looks up the agent's active session and rolls back
+     * to the checkpoint created at edit-start. This allows humans
+     * to stop an agent without knowing the session/checkpoint IDs.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param agentId - Agent ID to stop
+     */
+    stopAgent(siteId: string, branchId: string, documentPath: string, agentId: string): Promise<AgentStopResult>;
+}
+//# sourceMappingURL=agent-edit.d.ts.map

package/dist/endpoints/agent-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-edit.d.ts","sourceRoot":"","sources":["../../src/endpoints/agent-edit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;;;;OASG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAmB/B;;;;;;;;;;OAUG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAmB5B;;;;;;;;;OASG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,uBAAuB,CAAC;IAYnC;;;;;;;;;;OAUG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAYhC;;;;;;;;;;;OAWG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC;CAW5B"}

package/dist/endpoints/agent-edit.js

@@ -0,0 +1,125 @@
+/**
+ * Agent Edit Endpoint
+ *
+ * API endpoints for the agent edit workflow (politeness protocol).
+ */
+/**
+ * Agent edit endpoint for managing agent edit sessions.
+ */
+export class AgentEditEndpoint {
+    base;
+    constructor(base) {
+        this.base = base;
+    }
+    /**
+     * Encode document path for URL.
+     * Document paths start with / which needs proper encoding.
+     */
+    encodeDocumentPath(documentPath) {
+        return encodeURIComponent(documentPath);
+    }
+    /**
+     * Check if an agent can edit a document.
+     *
+     * Returns whether the agent can proceed and, if not, the reason why.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path (e.g., "/home")
+     * @param context - Agent edit context (agentId, trigger, intent, targetRegions)
+     */
+    async canEdit(siteId, branchId, documentPath, context) {
+        const encodedPath = this.encodeDocumentPath(documentPath);
+        return this.base.request(`/api/sites/${siteId}/branches/${branchId}/documents/${encodedPath}/can-agent-edit`, {
+            method: 'POST',
+            body: JSON.stringify({
+                agentId: context.agentId,
+                trigger: context.trigger,
+                requestedById: context.requestedById,
+                intent: context.intent,
+                targetRegions: context.targetRegions,
+                operationType: context.operationType,
+            }),
+        });
+    }
+    /**
+     * Start an agent edit session.
+     *
+     * Reserves the edit session, sets focus regions, and optionally creates
+     * a checkpoint for autonomous edits.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param context - Agent edit context
+     */
+    async startEdit(siteId, branchId, documentPath, context) {
+        const encodedPath = this.encodeDocumentPath(documentPath);
+        return this.base.request(`/api/sites/${siteId}/branches/${branchId}/documents/${encodedPath}/agent-edit-start`, {
+            method: 'POST',
+            body: JSON.stringify({
+                agentId: context.agentId,
+                trigger: context.trigger,
+                requestedById: context.requestedById,
+                intent: context.intent,
+                targetRegions: context.targetRegions,
+                operationType: context.operationType,
+            }),
+        });
+    }
+    /**
+     * Complete an agent edit session.
+     *
+     * Clears focus regions and updates checkpoint status.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param agentId - Agent ID
+     */
+    async completeEdit(siteId, branchId, documentPath, agentId) {
+        const encodedPath = this.encodeDocumentPath(documentPath);
+        return this.base.request(`/api/sites/${siteId}/branches/${branchId}/documents/${encodedPath}/agent-edit-complete`, {
+            method: 'POST',
+            body: JSON.stringify({ agentId }),
+        });
+    }
+    /**
+     * Abort an agent edit session.
+     *
+     * Rolls back to the checkpoint created at edit-start.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param agentId - Agent ID
+     * @param checkpointId - Checkpoint to rollback to
+     */
+    async abortEdit(siteId, branchId, documentPath, agentId, checkpointId) {
+        const encodedPath = this.encodeDocumentPath(documentPath);
+        return this.base.request(`/api/sites/${siteId}/branches/${branchId}/documents/${encodedPath}/agent-edit-abort`, {
+            method: 'POST',
+            body: JSON.stringify({ agentId, checkpointId }),
+        });
+    }
+    /**
+     * Stop an agent's edit session (human-initiated).
+     *
+     * Server looks up the agent's active session and rolls back
+     * to the checkpoint created at edit-start. This allows humans
+     * to stop an agent without knowing the session/checkpoint IDs.
+     *
+     * @param siteId - Site ID
+     * @param branchId - Branch ID
+     * @param documentPath - Document path
+     * @param agentId - Agent ID to stop
+     */
+    async stopAgent(siteId, branchId, documentPath, agentId) {
+        const encodedPath = this.encodeDocumentPath(documentPath);
+        return this.base.request(`/api/sites/${siteId}/branches/${branchId}/documents/${encodedPath}/agent-stop`, {
+            method: 'POST',
+            body: JSON.stringify({ agentId }),
+        });
+    }
+}
+//# sourceMappingURL=agent-edit.js.map

package/dist/endpoints/agent-edit.js.map

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

package/dist/endpoints/agent-registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Agent Registry Endpoint
+ *
+ * API endpoints for managing registered agents in an organization.
+ */
+import type { BaseEndpoint } from './base.js';
+import type { RegisteredAgent, CreateAgentParams, UpdateAgentParams, ListAgentsOptions, AgentStatus } from '../types.js';
+/**
+ * Agent registry endpoint for managing organization agents.
+ */
+export declare class AgentRegistryEndpoint {
+    private readonly base;
+    constructor(base: BaseEndpoint);
+    /**
+     * List all agents in an organization.
+     *
+     * @param orgId - Organization ID
+     * @param options - Optional filters (status)
+     */
+    list(orgId: string, options?: ListAgentsOptions): Promise<RegisteredAgent[]>;
+    /**
+     * Get a specific agent by ID.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     */
+    get(orgId: string, agentId: string): Promise<RegisteredAgent>;
+    /**
+     * Create a new agent in an organization.
+     *
+     * @param orgId - Organization ID
+     * @param params - Agent creation parameters
+     */
+    create(orgId: string, params: CreateAgentParams): Promise<RegisteredAgent>;
+    /**
+     * Update an agent's properties.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     * @param params - Properties to update
+     */
+    update(orgId: string, agentId: string, params: UpdateAgentParams): Promise<RegisteredAgent>;
+    /**
+     * Update an agent's status.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     * @param status - New status (active, suspended, disabled)
+     */
+    updateStatus(orgId: string, agentId: string, status: AgentStatus): Promise<RegisteredAgent>;
+    /**
+     * Delete an agent.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     */
+    delete(orgId: string, agentId: string): Promise<void>;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/endpoints/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/endpoints/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAgBlF;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAOnE;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAYhF;;;;;;OAMG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,eAAe,CAAC;IAU3B;;;;;;OAMG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC;IAU3B;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK5D"}

package/dist/endpoints/agent-registry.js

@@ -0,0 +1,96 @@
+/**
+ * Agent Registry Endpoint
+ *
+ * API endpoints for managing registered agents in an organization.
+ */
+/**
+ * Agent registry endpoint for managing organization agents.
+ */
+export class AgentRegistryEndpoint {
+    base;
+    constructor(base) {
+        this.base = base;
+    }
+    /**
+     * List all agents in an organization.
+     *
+     * @param orgId - Organization ID
+     * @param options - Optional filters (status)
+     */
+    async list(orgId, options) {
+        let path = `/api/organizations/${orgId}/agents`;
+        if (options?.status) {
+            const params = new URLSearchParams();
+            params.set('status', options.status);
+            path += `?${params.toString()}`;
+        }
+        const response = await this.base.request(path, {
+            method: 'GET',
+        });
+        return response.agents;
+    }
+    /**
+     * Get a specific agent by ID.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     */
+    async get(orgId, agentId) {
+        return this.base.request(`/api/organizations/${orgId}/agents/${agentId}`, { method: 'GET' });
+    }
+    /**
+     * Create a new agent in an organization.
+     *
+     * @param orgId - Organization ID
+     * @param params - Agent creation parameters
+     */
+    async create(orgId, params) {
+        return this.base.request(`/api/organizations/${orgId}/agents`, {
+            method: 'POST',
+            body: JSON.stringify({
+                name: params.name,
+                description: params.description,
+                capabilities: params.capabilities,
+                settings: params.settings,
+            }),
+        });
+    }
+    /**
+     * Update an agent's properties.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     * @param params - Properties to update
+     */
+    async update(orgId, agentId, params) {
+        return this.base.request(`/api/organizations/${orgId}/agents/${agentId}`, {
+            method: 'PATCH',
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Update an agent's status.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     * @param status - New status (active, suspended, disabled)
+     */
+    async updateStatus(orgId, agentId, status) {
+        return this.base.request(`/api/organizations/${orgId}/agents/${agentId}/status`, {
+            method: 'PUT',
+            body: JSON.stringify({ status }),
+        });
+    }
+    /**
+     * Delete an agent.
+     *
+     * @param orgId - Organization ID
+     * @param agentId - Agent ID
+     */
+    async delete(orgId, agentId) {
+        await this.base.request(`/api/organizations/${orgId}/agents/${agentId}`, {
+            method: 'DELETE',
+        });
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/endpoints/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../src/endpoints/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,OAA2B;QACnD,IAAI,IAAI,GAAG,sBAAsB,KAAK,SAAS,CAAC;QAEhD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAgC,IAAI,EAAE;YAC5E,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,OAAe;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,sBAAsB,KAAK,WAAW,OAAO,EAAE,EAC/C,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAyB;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,sBAAsB,KAAK,SAAS,EAAE;YAC9E,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAe,EACf,MAAyB;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,sBAAsB,KAAK,WAAW,OAAO,EAAE,EAC/C;YACE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B,CACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,OAAe,EACf,MAAmB;QAEnB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,sBAAsB,KAAK,WAAW,OAAO,SAAS,EACtD;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;SACjC,CACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAe;QACzC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAO,sBAAsB,KAAK,WAAW,OAAO,EAAE,EAAE;YAC7E,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/endpoints/base.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Base Endpoint
+ *
+ * Shared HTTP request logic for all endpoints.
+ */
+import type { AuthProvider } from '../auth.js';
+import type { Principal } from '../types.js';
+export interface BaseEndpointConfig {
+    baseUrl: string;
+    authProvider?: AuthProvider;
+    principal?: Principal;
+    /**
+     * Session ID for agent authorization.
+     * When set, the X-Agent-Session-Id header will be sent with all requests.
+     */
+    sessionId?: string;
+    /**
+     * Optional token refresher for dynamic token management.
+     * Called when a 401 Unauthorized response is received.
+     * Returns a fresh token string, or null if the session cannot be refreshed.
+     */
+    tokenRefresher?: () => Promise<string | null>;
+}
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+    body?: string;
+    headers?: Record<string, string>;
+}
+export declare class BaseEndpoint {
+    private readonly baseUrl;
+    private readonly authProvider?;
+    private readonly principal?;
+    private readonly sessionId?;
+    private readonly tokenRefresher?;
+    constructor(config: BaseEndpointConfig);
+    /**
+     * Make an authenticated HTTP request to the P1 API.
+     */
+    request<T>(path: string, options: RequestOptions): Promise<T>;
+    /**
+     * Create a new BaseEndpoint with updated principal.
+     */
+    withPrincipal(principal: Principal): BaseEndpoint;
+    /**
+     * Create a new BaseEndpoint with session ID for agent authorization.
+     */
+    withSessionId(sessionId: string): BaseEndpoint;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/endpoints/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/endpoints/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW7C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA+B;gBAEnD,MAAM,EAAE,kBAAkB;IAStC;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAkHnE;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY;IAUjD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;CAS/C"}