@felan-ai/agent-core 0.12.0 → 0.13.0

package/dist/index.js

@@ -1,4 +1,6 @@
 export { LOG_LEVELS, createLogger, createSilentLogger, isLogLevel, isLoggerLevel, } from './logger.js';
+export { USAGE_SERVICE } from './savings.js';
+export { FELAN_PLATFORM_SERVICE } from './platform.js';
 export { AGENT_CORE_VERSION } from './version.js';
 export * from './classifier/index.js';
 export * from './dynamic-thinking/index.js';
@@ -6,6 +8,14 @@ export { MODEL_TIERS, formatModelReference, getModelFamily, getModelStrength, is
 export { FELAN_THINKING_LEVELS, isFelanThinkingLevel } from './thinking.js';
 export { HostAgentRuntime } from './host-agent-runtime.js';
 export { bindFelanExtension, loadFelanExtensions, } from './extensions.js';
+export { createFelanServiceRegistry, defineServiceContract, createExtensionServiceAccess, HOST_RUNTIME_SERVICE } from './services.js';
+export { createUnavailableExtensionUi, ExtensionUiUnavailableError } from './extension-ui.js';
+export { MODELS_SERVICE } from './services/models.js';
+export { SECRETS_SERVICE, SECRETS_LIMITS, SecretServiceError } from './services/secrets.js';
+export { SESSIONS_SERVICE, SESSIONS_HISTORY_SERVICE, SESSION_EXECUTION_LIMITS, SESSION_HISTORY_LIMITS, SessionsServiceError, createReadOnlySessionsService } from './services/sessions.js';
+export { RUNTIME_DEPENDENCIES_SERVICE } from './services/runtime-dependencies.js';
+export { Type } from '@earendil-works/pi-ai';
+export { buildSessionContext, parseSessionEntries } from '@earendil-works/pi-coding-agent';
 export { associateExtensionConfig, configField, configureExtension, defineExtensionConfig, extensionConfigOverridesFromObject, getExtensionConfigCliOptions, getExtensionConfigDefinition, parseExtensionConfigCliValue, resolveExtensionConfigs, validateExtensionConfigValue, } from './extension-config.js';
 export { formatCapabilitiesSection } from './capabilities.js';
 export { FELAN_BASE_SYSTEM_PROMPT } from './system-prompt.js';
@@ -17,4 +27,5 @@ export { getProjectInstructions, PROJECT_INSTRUCTIONS_CUSTOM_TYPE, } from './ses
 export { AgentSession, CURRENT_SESSION_VERSION, DefaultResourceLoader, DynamicBorder, ModelRuntime, SessionManager, SettingsManager, createAgentSessionRuntime, createCodemodeExtension, defineTool, formatSkillsForPrompt, getAgentDir, loadSkillsFromDir, resizeImage, sessionEntryToContextMessages, withFileMutationQueue, } from '@earendil-works/pi-coding-agent';
 export { InMemoryCredentialStore, StringEnum, calculateCost, clampThinkingLevel, createAssistantMessageEventStream, getCurrentSystemPrompt, getCurrentTools, getSupportedThinkingLevels, isContextOverflow, lazyStream, normalizeContext, uuidv7, } from '@earendil-works/pi-ai';
 export { builtinProviders } from '@earendil-works/pi-ai/providers/all';
+export { HOST_WORKERS_SERVICE, RUNTIME_LIFETIME_SERVICE } from './host-workers.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AA4CrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,kCAAkC,EAClC,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAc/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAO9D,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGtG,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,cAAc,CAAC;AAStB,OAAO,EACL,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAkCzC,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,iCAAiC,EACjC,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,MAAM,GACP,MAAM,uBAAuB,CAAC;AAyB/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/platform.d.ts

@@ -0,0 +1,33 @@
+export type FelanApiMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export type FelanApiTarget = 'api' | 'docs';
+export type FelanApiQueryValue = string | number | boolean;
+export interface FelanApiRequest {
+    readonly target?: FelanApiTarget;
+    readonly method?: FelanApiMethod;
+    readonly path?: string;
+    readonly query?: Readonly<Record<string, FelanApiQueryValue>>;
+    readonly body?: unknown;
+}
+export interface FelanApiResultDetails {
+    readonly method: FelanApiMethod;
+    readonly target?: FelanApiTarget;
+    readonly path: string;
+    readonly ok: boolean;
+    readonly truncated: boolean;
+    readonly status?: number;
+    readonly error?: 'invalid_request' | 'request_too_large' | 'timeout' | 'network_error' | 'response_error' | 'http_error';
+}
+export interface FelanPlatformService {
+    readonly teamSlug?: string;
+    /** Results must be bounded, credential-redacted, and wrapped as untrusted content. */
+    execute(request: FelanApiRequest, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        details: FelanApiResultDetails;
+        isError?: true;
+    }>;
+}
+export declare const FELAN_PLATFORM_SERVICE: import("./services.js").ServiceContract<FelanPlatformService>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,SAAS,GAAG,eAAe,GAAG,gBAAgB,GAAG,YAAY,CAAC;CAC1H;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sFAAsF;IACtF,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAC/D,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,OAAO,EAAE,qBAAqB,CAAC;QAC/B,OAAO,CAAC,EAAE,IAAI,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,sBAAsB,+DAAmE,CAAC"}

package/dist/platform.js

@@ -0,0 +1,3 @@
+import { defineServiceContract } from './services.js';
+export const FELAN_PLATFORM_SERVICE = defineServiceContract('felan.platform', 1);
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAkCtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAuB,gBAAgB,EAAE,CAAC,CAAC,CAAC"}

package/dist/runtime-files.d.ts

@@ -0,0 +1,28 @@
+export interface RuntimeFileInfo {
+    readonly kind: 'file' | 'directory' | 'symlink' | 'other';
+    /** Opaque identity of this node, stable across renames but not replacement. */
+    readonly identity: string;
+    readonly size: number;
+    readonly modifiedAt: number;
+}
+export interface RuntimeFileSnapshot {
+    readonly info: RuntimeFileInfo;
+    readonly content: Uint8Array;
+    readonly truncated: boolean;
+}
+/** Atomic operations in the same authorized path namespace as AgentRuntime. */
+export interface RuntimeFiles {
+    inspect(path: string): Promise<RuntimeFileInfo>;
+    canonicalPath(path: string): Promise<string>;
+    move(source: string, target: string): Promise<void>;
+    removeEmptyDirectory(path: string): Promise<void>;
+    touch(path: string, modifiedAt: number): Promise<void>;
+    ensurePrivateDirectory(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /** Reads a bounded prefix of a regular file without following a symlink; rejects replacement or mutation. */
+    snapshot(path: string, maxBytes: number): Promise<RuntimeFileSnapshot>;
+    /** Never follows symlinks. An expected snapshot rejects replacement or mutation before appending. */
+    append(path: string, content: Uint8Array, expected?: RuntimeFileInfo): Promise<void>;
+}
+//# sourceMappingURL=runtime-files.d.ts.map

package/dist/runtime-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-files.d.ts","sourceRoot":"","sources":["../src/runtime-files.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1D,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,6GAA6G;IAC7G,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvE,qGAAqG;IACrG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF"}

package/dist/runtime-files.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-files.js.map

package/dist/runtime-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-files.js","sourceRoot":"","sources":["../src/runtime-files.ts"],"names":[],"mappings":""}

package/dist/runtime.d.ts

@@ -1,6 +1,7 @@
 import type { ExecOptions as PiExecOptions, ExecResult as PiExecResult } from '@earendil-works/pi-coding-agent';
 import type { Classifier } from './classifier/index.js';
 import type { Logger } from './logger.js';
+import type { RuntimeFiles } from './runtime-files.js';
 export type ExecOptions = PiExecOptions;
 export interface AgentRuntimeExecOptions extends PiExecOptions {
     /** Maximum combined stdout/stderr bytes retained by the host adapter. */
@@ -29,6 +30,7 @@ export interface AgentRuntimeProcessSnapshot {
     readonly nextOffset: number;
     readonly running: boolean;
     readonly exitCode?: number;
+    readonly signal?: AgentRuntimeTerminationSignal;
 }
 export interface AgentRuntimeProcess {
     readonly pid: number | undefined;
@@ -64,8 +66,13 @@ export interface AgentRuntimePrivateRuntime {
     /** Creates or validates an owner-private, deterministic directory for short-lived local coordination. */
     ensureDirectory(namespace: string): Promise<string>;
 }
+export interface AgentRuntimeTerminalOptions extends AgentRuntimeShellProcessOptions {
+    readonly id?: string;
+}
 export interface AgentRuntimeTerminals {
-    startShell(command: string, options?: AgentRuntimeShellProcessOptions): Promise<AgentRuntimeProcess>;
+    /** Reattaches a root-scoped terminal without transferring its host-owned lifetime. */
+    attach?(id: string): AgentRuntimeProcess | undefined;
+    startShell(command: string, options?: AgentRuntimeTerminalOptions): Promise<AgentRuntimeProcess>;
 }
 export interface AgentRuntimeStorage {
     readonly root: string;
@@ -85,12 +92,16 @@ export interface AgentRuntimeFileReadOptions {
 }
 export interface AgentRuntimeFileWriteOptions {
     readonly exclusive?: boolean;
+    readonly noFollow?: boolean;
+    readonly readOnly?: boolean;
 }
 export interface AgentRuntimeListFilesOptions {
     /** Traverse descendants instead of returning only immediate entries. */
     readonly recursive?: boolean;
     /** Include directories as well as regular files in the returned paths. */
     readonly includeDirectories?: boolean;
+    /** Include symlinks and special files without traversing them. */
+    readonly includeOther?: boolean;
     /** Maximum entry depth below the requested directory; immediate entries have depth 1. */
     readonly maxDepth?: number;
     /** Match returned paths with `/`-separated glob syntax. */
@@ -105,11 +116,18 @@ export interface AgentRuntimeListFilesOptions {
 export interface AgentRuntime {
     readonly kind: AgentRuntimeKind;
     readonly cwd: string;
+    readonly host?: {
+        readonly name: string;
+        readonly version: string;
+    };
+    /** User directory in the runtime path namespace, when user resources are available. */
+    readonly userHome?: string;
     readonly classifier?: Classifier;
     readonly logger: Logger;
     readonly processes?: AgentRuntimeProcesses;
     readonly privateRuntime?: AgentRuntimePrivateRuntime;
     readonly terminals?: AgentRuntimeTerminals;
+    readonly files?: RuntimeFiles;
     storage(scope?: AgentRuntimeStorageScope): AgentRuntimeStorage;
     exec(command: string, args: readonly string[], options?: AgentRuntimeExecOptions): Promise<ExecResult>;
     shell(command: string, options?: AgentRuntimeShellOptions): Promise<ExecResult>;
@@ -123,5 +141,6 @@ export interface AgentRuntime {
         recursive?: boolean;
     }): Promise<void>;
     readAgentFile?(path: string): Promise<Uint8Array>;
+    getEnvironmentVariable?(name: string): string | undefined;
 }
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

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

package/dist/savings.d.ts

@@ -37,4 +37,16 @@ export interface SavingsReporter {
 export interface SavingsReporterProvider {
     createReporter(producerId: string): SavingsReporter;
 }
+export interface SavingsSummary {
+    readonly savedCostUsd: number;
+    readonly hasUnpricedMeasurements: boolean;
+}
+export interface UsageService {
+    querySavings(query: {
+        readonly from: Date;
+        readonly to: Date;
+        readonly signal?: AbortSignal;
+    }): Promise<SavingsSummary>;
+}
+export declare const USAGE_SERVICE: import("./services.js").ServiceContract<UsageService>;
 //# sourceMappingURL=savings.d.ts.map

package/dist/savings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"savings.d.ts","sourceRoot":"","sources":["../src/savings.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,eAAe,GACf,oBAAoB,GACpB,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAAC;QAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACzC,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAAC;CACrD"}
+{"version":3,"file":"savings.d.ts","sourceRoot":"","sources":["../src/savings.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,eAAe,GACf,oBAAoB,GACpB,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAAC;QAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACzC,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzH;AAED,eAAO,MAAM,aAAa,uDAAwD,CAAC"}

package/dist/savings.js

@@ -1,2 +1,3 @@
-export {};
+import { defineServiceContract } from './services.js';
+export const USAGE_SERVICE = defineServiceContract('felan.usage', 1);
 //# sourceMappingURL=savings.js.map

package/dist/savings.js.map

@@ -1 +1 @@
-{"version":3,"file":"savings.js","sourceRoot":"","sources":["../src/savings.ts"],"names":[],"mappings":""}
+{"version":3,"file":"savings.js","sourceRoot":"","sources":["../src/savings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AA6DtD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAe,aAAa,EAAE,CAAC,CAAC,CAAC"}

package/dist/services/models.d.ts

@@ -0,0 +1,40 @@
+import type { Api, AssistantImages, AssistantMessage, AssistantMessageEventStream, Context, ImageApi, ImageModel, ImagesContext, Model, SimpleStreamOptions } from '@earendil-works/pi-ai';
+import type { Classifier } from '../classifier/types.js';
+import type { ModelReference } from '../model-tiers.js';
+export interface ModelsRequestOptions {
+    readonly signal?: AbortSignal;
+}
+export type ModelSubscriptionUsageResult = {
+    readonly ok: true;
+    readonly data: unknown;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: 'NO_CREDENTIALS' | 'COMPANION_UNAVAILABLE' | 'FETCH_FAILED' | 'HTTP_ERROR';
+        readonly httpStatus?: number;
+        readonly retryAfterMs?: number;
+    };
+};
+export type ModelsCallOptions = Readonly<Pick<SimpleStreamOptions, 'signal' | 'maxTokens' | 'reasoning' | 'timeoutMs' | 'maxRetries' | 'cacheRetention' | 'sessionId'>>;
+export type TextModelInfo = Readonly<Pick<Model<Api>, 'id' | 'name' | 'api' | 'provider' | 'input' | 'cost' | 'reasoning' | 'thinkingLevelMap' | 'contextWindow' | 'maxTokens'>>;
+export type ImageModelInfo = Readonly<Pick<ImageModel<ImageApi>, 'id' | 'name' | 'api' | 'provider' | 'type' | 'input' | 'output' | 'cost'>>;
+/**
+ * Implementations expose only this facade, never the underlying model runtime.
+ * Providers resolve model references against the current authenticated, allowed
+ * scope on every call. Caller model metadata and unlisted option keys must not
+ * reach provider dispatch. Availability describes selection metadata, not
+ * endpoint authority, headers or credentials.
+ * Request limits remain host-controlled. sessionId is a cache-affinity hint,
+ * not a session selector, and must be namespaced to the authorized scope.
+ */
+export interface ModelsService {
+    getSubscriptionUsage?(model: ModelReference, options?: ModelsRequestOptions): Promise<ModelSubscriptionUsageResult>;
+    getAvailable(providerId?: string, options?: ModelsRequestOptions): Promise<readonly TextModelInfo[]>;
+    completeSimple(model: ModelReference, context: Context, options?: ModelsCallOptions): Promise<AssistantMessage>;
+    streamSimple(model: ModelReference, context: Context, options?: ModelsCallOptions): AssistantMessageEventStream;
+    getAvailableOfType(type: 'image', providerId?: string, options?: ModelsRequestOptions): Promise<readonly ImageModelInfo[]>;
+    generateImages(model: ModelReference, context: ImagesContext, options?: ModelsRequestOptions): Promise<AssistantImages>;
+    readonly classifier?: Classifier;
+}
+export declare const MODELS_SERVICE: import("../services.js").ServiceContract<ModelsService>;
+//# sourceMappingURL=models.d.ts.map

package/dist/services/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/services/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC3B,OAAO,EACP,QAAQ,EACR,UAAU,EACV,aAAa,EACb,KAAK,EACL,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE;QACtC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,uBAAuB,GAAG,cAAc,GAAG,YAAY,CAAC;QAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAA;CAAE,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAC3C,mBAAmB,EACnB,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,CACnG,CAAC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAClD,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,kBAAkB,GAAG,eAAe,GAAG,WAAW,CACzH,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC7D,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAC1E,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB,CAAC,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACpH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACrG,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChH,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,2BAA2B,CAAC;IAChH,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAC3H,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,eAAO,MAAM,cAAc,yDAA0D,CAAC"}

package/dist/services/models.js

@@ -0,0 +1,3 @@
+import { defineServiceContract } from '../services.js';
+export const MODELS_SERVICE = defineServiceContract('felan.models', 1);
+//# sourceMappingURL=models.js.map

package/dist/services/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/services/models.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AA8CvD,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAgB,cAAc,EAAE,CAAC,CAAC,CAAC"}

package/dist/services/runtime-dependencies.d.ts

@@ -0,0 +1,16 @@
+export type RuntimeDependencyInstallResult = {
+    readonly status: 'installed';
+} | {
+    readonly status: 'cancelled' | 'unavailable';
+    readonly message: string;
+};
+/** Host policy selects known installers; session UI consent alone grants nothing. */
+export interface RuntimeDependenciesService {
+    install(request: {
+        readonly id: string;
+    }, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<RuntimeDependencyInstallResult>;
+}
+export declare const RUNTIME_DEPENDENCIES_SERVICE: import("../services.js").ServiceContract<RuntimeDependenciesService>;
+//# sourceMappingURL=runtime-dependencies.d.ts.map

package/dist/services/runtime-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-dependencies.d.ts","sourceRoot":"","sources":["../../src/services/runtime-dependencies.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,8BAA8B,GACtC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,qFAAqF;AACrF,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACjI;AAED,eAAO,MAAM,4BAA4B,sEAAqF,CAAC"}

package/dist/services/runtime-dependencies.js

@@ -0,0 +1,3 @@
+import { defineServiceContract } from '../services.js';
+export const RUNTIME_DEPENDENCIES_SERVICE = defineServiceContract('felan.runtime.dependencies', 1);
+//# sourceMappingURL=runtime-dependencies.js.map

package/dist/services/runtime-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-dependencies.js","sourceRoot":"","sources":["../../src/services/runtime-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAWvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAA6B,4BAA4B,EAAE,CAAC,CAAC,CAAC"}

package/dist/services/secrets.d.ts

@@ -0,0 +1,39 @@
+export interface SecretAddress {
+    readonly namespace: string;
+    readonly key: string;
+}
+export interface SecretRecord {
+    readonly value: string;
+    /** Opaque content identity, not a monotonic revision or an authorization token. */
+    readonly version: string;
+}
+export interface SecretsRequestOptions {
+    readonly signal?: AbortSignal;
+}
+/**
+ * Grant only to trusted credential consumers. Namespace selection addresses
+ * storage within the provider's grant; it does not authorize a new namespace.
+ * An address outside the grant fails with unavailable, not an absent record.
+ * Values must stay out of model-facing results, UI, logs and durable events.
+ */
+export interface SecretsService {
+    read(address: SecretAddress, options?: SecretsRequestOptions): Promise<SecretRecord | undefined>;
+    write(address: SecretAddress, record: {
+        readonly value: string;
+        readonly expectedVersion: string | null;
+    }, options?: SecretsRequestOptions): Promise<SecretRecord>;
+    remove(address: SecretAddress, expectedVersion: string, options?: SecretsRequestOptions): Promise<void>;
+}
+export type SecretServiceErrorCode = 'invalid' | 'unavailable' | 'conflict';
+export declare class SecretServiceError extends Error {
+    readonly code: SecretServiceErrorCode;
+    constructor(code: SecretServiceErrorCode);
+}
+export declare const SECRETS_LIMITS: Readonly<{
+    namespaceBytes: 64;
+    keyBytes: 128;
+    valueBytes: number;
+    versionBytes: 128;
+}>;
+export declare const SECRETS_SERVICE: import("../services.js").ServiceContract<SecretsService>;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/services/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/services/secrets.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACjG,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnK,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzG;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAQ5E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB;CAMzC;AAED,eAAO,MAAM,cAAc;;;;;EAAiG,CAAC;AAC7H,eAAO,MAAM,eAAe,0DAA4D,CAAC"}

package/dist/services/secrets.js

@@ -0,0 +1,18 @@
+import { defineServiceContract } from '../services.js';
+const messages = {
+    invalid: 'Secret request is invalid.',
+    unavailable: 'Secret storage is unavailable.',
+    conflict: 'Secret version conflict.',
+};
+export class SecretServiceError extends Error {
+    code;
+    constructor(code) {
+        const safeCode = code === 'unavailable' || code === 'conflict' ? code : 'invalid';
+        super(messages[safeCode]);
+        this.name = 'SecretServiceError';
+        this.code = safeCode;
+    }
+}
+export const SECRETS_LIMITS = Object.freeze({ namespaceBytes: 64, keyBytes: 128, valueBytes: 64 * 1024, versionBytes: 128 });
+export const SECRETS_SERVICE = defineServiceContract('felan.secrets', 1);
+//# sourceMappingURL=secrets.js.map

package/dist/services/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/services/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AA+BvD,MAAM,QAAQ,GAA2C;IACvD,OAAO,EAAE,4BAA4B;IACrC,WAAW,EAAE,gCAAgC;IAC7C,QAAQ,EAAE,0BAA0B;CACrC,CAAC;AAEF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAyB;IAEtC,YAAY,IAA4B;QACtC,MAAM,QAAQ,GAAG,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7H,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAiB,eAAe,EAAE,CAAC,CAAC,CAAC"}

package/dist/services/sessions.d.ts

@@ -0,0 +1,160 @@
+import type { SessionEntry } from '@earendil-works/pi-coding-agent';
+import type { ModelReference } from '../model-tiers.js';
+import type { FelanThinkingLevel } from '../thinking.js';
+export interface SessionsRequestOptions {
+    readonly signal?: AbortSignal;
+}
+export interface SessionPageOptions extends SessionsRequestOptions {
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+export interface SessionPage<T> {
+    readonly items: readonly T[];
+    readonly nextCursor?: string;
+}
+export interface SessionRef {
+    readonly id: string;
+    readonly root: string;
+    readonly parent?: string;
+}
+export interface SessionHistoryInfo extends SessionRef {
+    readonly title: string;
+    /** Display metadata in the runtime's path namespace, never a storage selector. */
+    readonly cwd: string;
+    readonly updatedAt: number;
+    readonly state: 'open' | 'closed';
+    readonly diagnostic?: 'inaccessible' | 'oversize' | 'unsupported';
+}
+export interface HistoryRevision {
+    readonly sessionId: string;
+    /** Content identity, independent of the daemon's control/projection counter. */
+    readonly revision: string;
+    /** The selected leaf entry ID; history may also contain abandoned branches. */
+    readonly branch: string | null;
+}
+export interface SessionHistoryOptions extends SessionPageOptions {
+    readonly at?: HistoryRevision;
+}
+export interface SessionHistoryPage extends HistoryRevision {
+    readonly entries: readonly SessionEntry[];
+    /** Original parseable header timestamp, repeated on every page when available. */
+    readonly startedAt?: string;
+    readonly nextCursor?: string;
+}
+export interface SessionCheckpointRef extends HistoryRevision {
+    /** UTF-8 byte length of the provider's complete source snapshot, before branch selection. */
+    readonly byteLength: number;
+    /**
+     * Lowercase hexadecimal SHA-256 of a compact UTF-8 JSON array, root to selected
+     * leaf (empty array for null). Object keys sort by JavaScript string order;
+     * primitives use JSON.stringify formatting. Entries must be valid JSON.
+     */
+    readonly transcriptDigest: string;
+}
+export interface SessionExecution {
+    readonly id: string;
+    readonly parent?: string;
+    readonly label?: string;
+    readonly description?: string;
+    readonly createdAt?: string;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly completionPending?: boolean;
+    readonly model?: ModelReference;
+    readonly usage?: {
+        readonly input: number;
+        readonly output: number;
+        readonly cacheRead: number;
+        readonly cacheWrite: number;
+        readonly cacheWrite1h: number;
+        readonly cost: number;
+    };
+    /** Absent until the queued execution has a canonically registered session. */
+    readonly session?: SessionRef;
+    readonly state: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+    readonly result?: {
+        readonly text: string;
+        readonly error?: string;
+        readonly truncated: boolean;
+    };
+}
+export interface SessionExecutionInput {
+    readonly prompt: string;
+    /** Additional instructions; providers must retain the base prompt and project instructions. */
+    readonly appendSystemPrompt?: string;
+    readonly model?: ModelReference;
+    readonly thinking?: FelanThinkingLevel;
+    readonly description: string;
+    readonly maxTurns?: number;
+    readonly timeoutMs?: number;
+    readonly label?: string;
+    readonly allowChildren?: boolean;
+    readonly excludedTools?: readonly string[];
+    readonly notifyOnCompletion?: boolean;
+}
+export interface SessionExecutionsOptions extends SessionPageOptions {
+    /** Descendants are visible but only direct children can be controlled. */
+    readonly includeDescendants?: boolean;
+}
+export interface SessionExecutionReadOptions extends SessionsRequestOptions {
+    readonly acknowledge?: boolean;
+}
+export interface SessionsEvent {
+    readonly kind: 'history' | 'execution';
+    /** A history event identifies a session; an execution event identifies an execution record. */
+    readonly id: string;
+}
+/** Providers must expose a separate frozen facade with only these members. */
+export interface SessionsHistory {
+    readonly current: SessionRef;
+    /** Filters an already authorized inventory; project/cwd equality never grants access. */
+    list(filter: {
+        readonly scope: 'root' | 'project' | 'visible';
+    }, options?: SessionPageOptions): Promise<SessionPage<SessionHistoryInfo>>;
+    /**
+     * Complete, unfiltered Pi entries in append order, parents before children.
+     * Entries are untrusted data. Cursors pin session, revision and selected leaf;
+     * any changed source or mismatched pin fails with stale, never a mixed page.
+     */
+    history(id: string, options?: SessionHistoryOptions): Promise<SessionHistoryPage>;
+    checkpoint(id: string, options?: SessionsRequestOptions): Promise<SessionCheckpointRef>;
+}
+export interface SessionsService extends SessionsHistory {
+    setTitleIfMissing(title: string, requestId: string, options?: SessionsRequestOptions): Promise<boolean>;
+    /** Admission rechecks scope. Invalid or out-of-range requests reject, never clamp. */
+    create(input: SessionExecutionInput, options?: SessionsRequestOptions): Promise<SessionExecution>;
+    /** Only executions owned by this parent are readable and controllable through this handle. */
+    executions(options?: SessionExecutionsOptions): Promise<SessionPage<SessionExecution>>;
+    execution(id: string, options?: SessionExecutionReadOptions): Promise<SessionExecution>;
+    steer(id: string, message: string, options?: SessionsRequestOptions): Promise<void>;
+    cancel(id: string, reason?: string, options?: SessionsRequestOptions): Promise<void>;
+    /** Events use the same history and execution visibility as this handle's reads. */
+    subscribe(listener: (event: SessionsEvent) => void): () => void;
+}
+export type SessionsServiceErrorCode = 'invalid' | 'inaccessible' | 'stale' | 'oversize' | 'unsupported';
+export declare class SessionsServiceError extends Error {
+    readonly code: SessionsServiceErrorCode;
+    constructor(code: SessionsServiceErrorCode, message?: string);
+}
+export declare const SESSION_HISTORY_LIMITS: Readonly<{
+    fileBytes: number;
+    pageBytes: number;
+    pageEntries: 256;
+}>;
+export declare const SESSION_EXECUTION_LIMITS: Readonly<{
+    maxTurns: 100;
+    timeoutMs: 86400000;
+    promptBytes: number;
+    appendSystemPromptBytes: number;
+    descriptionBytes: 512;
+    steerBytes: number;
+    cancelReasonBytes: 4096;
+    titleBytes: 4096;
+    requestIdBytes: 128;
+    resultTextBytes: number;
+    resultErrorBytes: 4096;
+}>;
+export declare function createReadOnlySessionsService(source: SessionsHistory): SessionsHistory;
+export declare const SESSIONS_HISTORY_SERVICE: import("../services.js").ServiceContract<SessionsHistory>;
+export declare const SESSIONS_SERVICE: import("../services.js").ServiceContract<SessionsService>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/services/sessions.d.ts.map

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