@dxos/compute 0.8.4-main.fd6878d → 0.9.0

package/dist/types/src/OperationRegistry.d.ts

@@ -0,0 +1,23 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Option from 'effect/Option';
+import { Database } from '@dxos/echo';
+import * as Operation from './Operation';
+import * as OperationHandlerSet from './OperationHandlerSet';
+export interface OperationRegistry {
+    /**
+     * Resolve an operation by key.
+     */
+    resolve(key: string): Effect.Effect<Option.Option<Operation.Definition.Any>>;
+}
+declare const Service_base: Context.TagClass<Service, "@dxos/operation/OperationRegistry", OperationRegistry>;
+export declare class Service extends Service_base {
+}
+/**
+ * Resolve an operation by key.
+ */
+export declare const resolve: (key: string) => Effect.Effect<Option.Option<Operation.Definition.Any>, never, Service>;
+export declare const layer: Layer.Layer<Service, never, Database.Service | OperationHandlerSet.OperationHandlerProvider>;
+export {};
+//# sourceMappingURL=OperationRegistry.d.ts.map

package/dist/types/src/OperationRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationRegistry.d.ts","sourceRoot":"","sources":["../../../src/OperationRegistry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9E;;AAED,qBAAa,OAAQ,SAAQ,YAA8E;CAAG;AAE9G;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,CACvC,CAAC;AAEtE,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,mBAAmB,CAAC,wBAAwB,CAkB5G,CAAC"}

package/dist/types/src/Process.d.ts

@@ -0,0 +1,255 @@
+import type { Atom } from '@effect-atom/atom';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import type * as Exit from 'effect/Exit';
+import * as Option from 'effect/Option';
+import * as Schema from 'effect/Schema';
+import * as Scope from 'effect/Scope';
+import type * as Types from 'effect/Types';
+import { type URI } from '@dxos/keys';
+import * as Operation from './Operation';
+import * as OperationHandlerSet from './OperationHandlerSet';
+import * as StorageService from './StorageService';
+import * as Trace from './Trace';
+/** Opaque process id (arbitrary string). */
+export declare const ID: Schema.brand<typeof Schema.String, "ProcessId">;
+export type ID = Schema.Schema.Type<typeof ID>;
+/**
+ * A running process callbacks.
+ *
+ * Process lifecycle: Initial -> Running <-> Suspended -> Terminated.
+ *
+ * - onSpawn -> called once when the process is spawned.
+ * - onInput -> called for every input submitted to the process.
+ * - onAlarm -> called for processes scheduling alarms.
+ * - onChildEvent -> called when child process produces output or exits.
+ */
+export interface Callbacks<I, O, R> {
+    /**
+     * Called when the process is spawned.
+     * Not called for processes that are resumed from a previously suspended state.
+     *
+     * @returns A signal indicating to the runtime whether the process is finished, or should be resumed later.
+     * @throws Throwing in the handler will terminate the process with an error.
+     *
+     * Note: This function should aim to complete in under 5 seconds to avoid exceeding limits in serverless environments.
+     */
+    onSpawn(): Effect.Effect<void, never, R | BaseServices>;
+    /**
+     * Called when there's input available to process.
+     *
+     * The function can be called in parallel.
+     *
+     * @returns A signal indicating to the runtime whether the process is finished, or should be resumed later.
+     * @throws Throwing in the handler will terminate the process with an error.
+     *
+     * Note: This function should aim to complete in under 5 seconds to avoid exceeding limits in serverless environments.
+     */
+    onInput(input: I): Effect.Effect<void, never, R | BaseServices>;
+    /**
+     * Called when the process's alarm is triggered.
+     *
+     * @throws Throwing in the handler will terminate the process with an error.
+     */
+    onAlarm(): Effect.Effect<void, never, R | BaseServices>;
+    /**
+     * Called when the process's child process produces output or exits.
+     *
+     * This allows the parent process to hibernate while a long-running child process is running.
+     */
+    onChildEvent(event: ChildEvent<unknown>): Effect.Effect<void, never, R | BaseServices>;
+}
+/**
+ * Services that are always available to all processes.
+ * Provided unconditionally by the runtime, so handlers may use them without declaring them
+ * in {@link MakeProcessOpts.services}.
+ */
+export type BaseServices = Trace.TraceService | StorageService.StorageService;
+export type ChildEvent<T> = {
+    readonly _tag: 'output';
+    readonly pid: ID;
+    readonly data: T;
+} | {
+    readonly _tag: 'exited';
+    readonly pid: ID;
+    readonly result: Exit.Exit<void>;
+};
+export interface ProcessContext<I, O> {
+    readonly id: ID;
+    /**
+     * Parameters assigned during process creation.
+     */
+    readonly params: Params;
+    /**
+     * Complete this process with sucessful result.
+     * No additional events will be pushed to the process.
+     */
+    succeed(): void;
+    /**
+     * Complete this process with an error.
+     * No additional events will be pushed to the process.
+     */
+    fail(error: Error): void;
+    /**
+     * Submit output of the process.
+     */
+    submitOutput(output: O): void;
+    /**
+     * Set an alarm for the process to be woken up later.
+     *
+     * @param timeout - Optional timeout in milliseconds. If not provided, the process is woken up as soon as possible.
+     */
+    setAlarm(timeout?: number): void;
+}
+/**
+ * Generic parameters for a all processes.
+ */
+export interface Params {
+    /**
+     * Process name for debugging purposes.
+     */
+    readonly name: string | null;
+    /**
+     * URI of the target this process is assigned to.
+     */
+    readonly target: URI.URI | null;
+    /**
+     * User-facing notifications requested for this process's lifecycle phases.
+     * Surfaced on {@link Info} so a notification tracker can subscribe to the process monitor.
+     */
+    readonly notify?: Operation.NotifyOptions;
+}
+export declare const ProcessTypeId: '~@dxos/functions/Process';
+export type ProcessTypeId = typeof ProcessTypeId;
+/**
+ * A process (factory).
+ * Can be instantiated mutlitple times to produce new runtime instance with separate state and callbacks.
+ * `create` is used to instantiate a new process.
+ * Can store runtime state in scope of `create` function.
+ */
+export interface Process<I, O, R> extends Process.Variance<I, O, R> {
+    /**
+     * Unique identifier for the executable in the reverse DNS format.
+     */
+    readonly key: string;
+    /**
+     * Human-readable label from {@link MakeExecutableOpts.name} when provided.
+     */
+    readonly name?: string;
+    readonly services: readonly Context.Tag<any, any>[];
+    /**
+     * Create a new instance of the process.
+     */
+    create(ctx: ProcessContext<I, O>): Effect.Effect<Callbacks<I, O, R>, never, R | BaseServices | Scope.Scope>;
+}
+export declare const isProcess: (executable: unknown) => executable is Process.Any;
+export declare namespace Process {
+    interface Variance<I, O, R> {
+        readonly [ProcessTypeId]: {
+            readonly _Input: Types.Contravariant<I>;
+            readonly _Output: Types.Covariant<O>;
+            readonly _Requirements: Types.Covariant<R>;
+        };
+    }
+    type Any = Process<any, any, never>;
+}
+export interface MakeProcessOpts {
+    /**
+     * Unique identifier for the process in the reverse DNS format.
+     */
+    readonly key: string;
+    readonly input: Schema.Schema.AnyNoContext;
+    readonly output: Schema.Schema.AnyNoContext;
+    readonly services: readonly Context.Tag<any, any>[];
+}
+export declare const make: <const Opts extends Types.NoExcessProperties<MakeProcessOpts, Opts>>(opts: Opts, create: (ctx: ProcessContext<Schema.Schema.Type<Opts['input']>, Schema.Schema.Type<Opts['output']>>) => Effect.Effect<Partial<Callbacks<Schema.Schema.Type<Opts['input']>, Schema.Schema.Type<Opts['output']>, Context.Tag.Identifier<NonNullable<Opts['services']>[number]>>>, never, Context.Tag.Identifier<NonNullable<Opts['services']>[number]> | BaseServices | Scope.Scope>) => Process<Schema.Schema.Type<Opts['input']>, Schema.Schema.Type<Opts['output']>, Context.Tag.Identifier<NonNullable<Opts['services']>[number]>>;
+export declare const fromOperation: <const Op extends Operation.Definition.Any>(op: Op, handler: OperationHandlerSet.OperationHandlerSet) => Process<Operation.Definition.Input<Op>, Operation.Definition.Output<Op>, Operation.Definition.Services<Op>>;
+/**
+ * Runtime state of a process.
+ */
+export declare enum State {
+    RUNNING = "RUNNING",
+    HYBERNATING = "HYBERNATING",
+    IDLE = "IDLE",
+    TERMINATING = "TERMINATING",
+    TERMINATED = "TERMINATED",
+    SUCCEEDED = "SUCCEEDED",
+    FAILED = "FAILED"
+}
+/**
+ * Read-only view of a process tree
+ */
+export interface Monitor {
+    /**
+     * Get the current state of the process tree.
+     */
+    processTree: Effect.Effect<readonly Info[]>;
+    /**
+     * Atom for the process tree.
+     */
+    processTreeAtom: Atom.Atom<readonly Info[]>;
+}
+declare const ProcessMonitorService_base: Context.TagClass<ProcessMonitorService, "@dxos/functions/ProcessMonitorService", Monitor>;
+export declare class ProcessMonitorService extends ProcessMonitorService_base {
+}
+export interface Info {
+    readonly pid: ID;
+    readonly parentPid: ID | null;
+    /**
+     * Key of the process.
+     *
+     * NOTE: There might be multiple running processes with the same key.
+     */
+    readonly key: string;
+    /**
+     * Parameters of the process.
+     */
+    readonly params: Params;
+    /**
+     * State of the process.
+     */
+    readonly state: State;
+    /**
+     * Error of the process.
+     * Only for process in FAILED state.
+     */
+    readonly error: string | null;
+    /**
+     * UNIX timestamp in milliseconds.
+     */
+    readonly startedAt: number;
+    /**
+     * UNIX timestamp in milliseconds.
+     */
+    readonly completedAt: Option.Option<number>;
+    readonly metrics: {
+        /**
+         * Total wall time of all handler invocations of the process in milliseconds.
+         */
+        readonly wallTime: number;
+        /**
+         * Total number of inputs submitted to the process.
+         */
+        readonly inputCount: number;
+        /**
+         * Total number of outputs submitted to the process.
+         */
+        readonly outputCount: number;
+    };
+}
+/**
+ * New process is spawned.
+ */
+export declare const SpawnedEvent: Trace.EventType<void>;
+/**
+ * Process has reached a terminal state.
+ */
+export declare const ExitedEvent: Trace.EventType<{
+    readonly outcome: "failed" | "succeeded" | "terminated";
+}>;
+/**
+ * Renders spawned processes as a forest: top-level rows use "- ", nested rows use ├── / └── / │.
+ */
+export declare const prettyProcessTree: (tree: readonly Info[]) => string;
+export {};
+//# sourceMappingURL=Process.d.ts.map

package/dist/types/src/Process.d.ts.map

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

package/dist/types/src/Routine.d.ts

@@ -0,0 +1,54 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Ref, Type } from '@dxos/echo';
+import * as Blueprint from './Blueprint';
+/**
+ * Prompt-based operation.
+ * May reference blueprints and additional context.
+ */
+export declare const Routine: Type.Obj<{
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    readonly input: import("@dxos/echo/internal").JsonSchemaType;
+    readonly output: import("@dxos/echo/internal").JsonSchemaType;
+    readonly instructions: import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly content: string;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    readonly blueprints: readonly import("@dxos/echo/internal").Ref<{
+        readonly name: string;
+        readonly description?: string | undefined;
+        readonly instructions: {
+            readonly source: import("@dxos/echo/internal").Ref<{
+                readonly name?: string | undefined;
+                readonly content: string;
+            } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+            readonly inputs?: readonly {
+                readonly name: string;
+                readonly kind: "operation" | "value";
+                readonly default?: any;
+                readonly operation?: string | undefined;
+            }[] | undefined;
+        };
+        readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+        readonly agentCanEnable?: boolean | undefined;
+        readonly mcpServers?: readonly {
+            readonly name?: string | undefined;
+            readonly url: string;
+            readonly protocol: "http" | "sse";
+            readonly apiKey?: string | undefined;
+        }[] | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
+    readonly context: readonly any[];
+}, Schema.Struct.Fields>;
+export type Routine = Type.InstanceType<typeof Routine>;
+export type MakeProps = {
+    name?: string;
+    description?: string;
+    input?: Schema.Schema.AnyNoContext;
+    output?: Schema.Schema.AnyNoContext;
+    instructions?: string;
+    blueprints?: Ref.Ref<Blueprint.Blueprint>[];
+    context?: any[];
+};
+export declare const make: ({ name, description, input, output, instructions, blueprints, context, }: MakeProps) => Routine;
+//# sourceMappingURL=Routine.d.ts.map

package/dist/types/src/Routine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Routine.d.ts","sourceRoot":"","sources":["../../../src/Routine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAA+B,GAAG,EAAE,GAAG,EAAE,IAAI,EAAU,MAAM,YAAY,CAAC;AAGjF,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmBnB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,OAAO,CAAC,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,IAAI,6EAQd,SAAS,KAAG,OASX,CAAC"}

package/dist/types/src/Script.d.ts

@@ -0,0 +1,21 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Type } from '@dxos/echo';
+/**
+ * Source script.
+ */
+export declare const Script: Type.Obj<{
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    readonly changed?: boolean | undefined;
+    readonly source: import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly content: string;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+}, Schema.Struct.Fields>;
+export type Script = Type.InstanceType<typeof Script>;
+type Props = Omit<Obj.MakeProps<typeof Script>, 'source'> & {
+    source?: string;
+};
+export declare const make: ({ source, ...props }?: Props) => Script;
+export {};
+//# sourceMappingURL=Script.d.ts.map

package/dist/types/src/Script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Script.d.ts","sourceRoot":"","sources":["../../../src/Script.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAmB,GAAG,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAI7D;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;wBAWlB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC;AACtD,KAAK,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,eAAO,MAAM,IAAI,0BAA+B,KAAK,KAAQ,MACqB,CAAC"}

package/dist/types/src/ServiceResolver.d.ts

@@ -0,0 +1,92 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Scope from 'effect/Scope';
+import type { SpaceId, URI } from '@dxos/keys';
+import { ServiceNotAvailableError } from './errors';
+import * as Process from './Process';
+declare const ServiceResolverTypeId: '~@dxos/functions/ServiceResolver';
+type ServiceResolverTypeId = typeof ServiceResolverTypeId;
+export interface ServiceResolver {
+    readonly [ServiceResolverTypeId]: ServiceResolverTypeId;
+    /**
+     * Resolve a set of services identified by their tags.
+     * Returns a Context containing all requested services, or fails with ServiceNotAvailableError.
+     */
+    resolve<Tag extends Context.Tag<any, any>>(tag: Tag, context: ResolutionContext): Effect.Effect<Context.Tag.Service<Tag>, ServiceNotAvailableError, Scope.Scope>;
+}
+/**
+ * Tag for the ServiceResolver service.
+ */
+export declare const ServiceResolver: Context.Tag<ServiceResolver, ServiceResolver>;
+export declare const resolve: {
+    <Tag extends Context.Tag<any, any>>(tag: Tag, context: ResolutionContext): Effect.Effect<Context.Tag.Service<Tag>, ServiceNotAvailableError, Scope.Scope | ServiceResolver>;
+};
+export declare const resolveAll: <const Tags extends readonly Context.Tag<any, any>[]>(tags: Tags, context: ResolutionContext) => Effect.Effect<Context.Context<Tags[number]>, ServiceNotAvailableError, Scope.Scope | ServiceResolver>;
+/**
+ * Provides context for service resolution.
+ */
+export interface ResolutionContext {
+    /**
+     * Under which identity the process is running.
+     */
+    readonly identity?: string;
+    /**
+     * Under which space the process is running.
+     */
+    readonly space?: SpaceId;
+    /**
+     * URI of the conversation feed the process is running in. Today always an EID;
+     * narrow with `EID.parse` at the point of use.
+     */
+    readonly conversation?: URI.URI;
+    /**
+     * Under which process the process is running.
+     */
+    readonly process?: Process.ID;
+}
+export declare const succeed: <I, S>(tag: Context.Tag<I, S>, getService: (context: ResolutionContext) => Effect.Effect<S, ServiceNotAvailableError, Scope.Scope>) => ServiceResolver;
+/**
+ * Create a ServiceResolver from a custom resolution function.
+ */
+export declare const make: (resolveFn: <I, S>(tag: Context.Tag<I, S>, context: ResolutionContext) => Effect.Effect<S, ServiceNotAvailableError, Scope.Scope>) => ServiceResolver;
+/**
+ * Create a ServiceResolver backed by a static Context.
+ * Tags present in the context are resolved; missing tags fail with ServiceNotAvailableError.
+ */
+export declare const fromContext: <Services>(ctx: Context.Context<Services>) => ServiceResolver;
+/**
+ * Create a ServiceResolver that resolves tags from the current Effect context.
+ * Only the specified tags are available; requests for other tags fail.
+ */
+export declare const fromRequirements: <const Tags extends readonly Context.Tag<any, any>[]>(...tags: Tags) => Effect.Effect<ServiceResolver, never, Context.Tag.Identifier<Tags[number]>>;
+/**
+ * Like {@link fromRequirements} but returns a Layer that provides ServiceResolver.
+ */
+export declare const layerRequirements: <const Tags extends readonly Context.Tag<any, any>[]>(...tags: Tags) => Layer.Layer<ServiceResolver, never, Context.Tag.Identifier<Tags[number]>>;
+/**
+ * Build a {@link Layer} that materialises the requested services by calling
+ * {@link resolveAll} against the {@link ServiceResolver} currently in context.
+ *
+ * The returned layer manages its own {@link Scope.Scope} and requires only a
+ * {@link ServiceResolver} (typically supplied by the process-manager runtime).
+ *
+ * @example
+ * ```ts
+ * processManagerRuntime.runPromise(
+ *   myEffect.pipe(Effect.provide(ServiceResolver.provide({ space }, Database.Service, Feed.FeedService))),
+ * );
+ * ```
+ */
+export declare const provide: <const Tags extends readonly Context.Tag<any, any>[]>(context: ResolutionContext, ...tags: Tags) => Layer.Layer<Context.Tag.Identifier<Tags[number]>, ServiceNotAvailableError, ServiceResolver>;
+/**
+ * Compose multiple resolvers left to right. Earlier resolvers take precedence:
+ * the first resolver that can satisfy a tag wins.
+ */
+export declare const compose: (...resolvers: readonly ServiceResolver[]) => ServiceResolver;
+/**
+ * An empty resolver that fails for any requested service.
+ */
+export declare const empty: ServiceResolver;
+export {};
+//# sourceMappingURL=ServiceResolver.d.ts.map

package/dist/types/src/ServiceResolver.d.ts.map

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

package/dist/types/src/StorageService.d.ts

@@ -0,0 +1,58 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Option from 'effect/Option';
+import * as Pipeable from 'effect/Pipeable';
+import * as Schema from 'effect/Schema';
+export interface Service {
+    /** Read a value by key. Returns `None` if key does not exist. */
+    get<S extends Schema.Schema<any, string, any>>(schema: S, key: string): Effect.Effect<Option.Option<Schema.Schema.Type<S>>, never, Schema.Schema.Context<S>>;
+    /** Write a value for the given key. */
+    set<S extends Schema.Schema<any, string, any>>(schema: S, key: string, value: Schema.Schema.Type<S>): Effect.Effect<void, never, Schema.Schema.Context<S>>;
+    /** Remove a key. */
+    delete(key: string): Effect.Effect<void>;
+    /** List all keys, optionally filtered by prefix. */
+    list(prefix?: string): Effect.Effect<readonly string[]>;
+    /** Remove all keys managed by this scoped store. */
+    clear(): Effect.Effect<void>;
+}
+declare const StorageService_base: Context.TagClass<StorageService, "@dxos/functions/StorageService", Service>;
+/**
+ * Scoped key-value storage service for processes.
+ * Each process receives its own namespaced instance via the process manager.
+ * Construct a live implementation with `StorageService.layer` from `@dxos/functions-runtime`.
+ */
+export declare class StorageService extends StorageService_base {
+}
+export declare const get: <S extends Schema.Schema<any, string, any>>(schema: S, key: string) => Effect.Effect<Option.Option<Schema.Schema.Type<S>>, never, StorageService | Schema.Schema.Context<S>>;
+export declare const set: <S extends Schema.Schema<any, string, any>>(schema: S, key: string, value: Schema.Schema.Type<S>) => Effect.Effect<void, never, StorageService | Schema.Schema.Context<S>>;
+export declare const deleteKey: (key: string) => Effect.Effect<void, never, StorageService>;
+export declare const list: (prefix?: string | undefined) => Effect.Effect<readonly string[], never, StorageService>;
+export declare const clear: () => Effect.Effect<void, never, StorageService>;
+/**
+ * Typed key in a storage service.
+ */
+export interface Key<T> extends Pipeable.Pipeable {
+    readonly key: string;
+    get: Effect.Effect<Option.Option<T>, never, StorageService>;
+    set(value: T): Effect.Effect<void, never, StorageService>;
+    delete(): Effect.Effect<void, never, StorageService>;
+}
+/**
+ * Create a typed key in a storage service.
+ */
+export declare const key: <S extends Schema.Schema<any, string, any>>(schema: S, key: string) => Key<Schema.Schema.Type<S>>;
+/**
+ * Typed key in a storage service with a default value.
+ */
+export interface KeyWithDefault<T, U> extends Pipeable.Pipeable {
+    readonly key: string;
+    get: Effect.Effect<T | U, never, StorageService>;
+    set(value: U): Effect.Effect<void, never, StorageService>;
+    delete(): Effect.Effect<void, never, StorageService>;
+}
+/**
+ * Assign a default value to a key if it is not present.
+ */
+export declare const withDefault: <T>(getDefault: () => NoInfer<T>) => (key: Key<T>) => KeyWithDefault<T, T>;
+export {};
+//# sourceMappingURL=StorageService.d.ts.map

package/dist/types/src/StorageService.d.ts.map

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

package/dist/types/src/Template.d.ts

@@ -0,0 +1,61 @@
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { Registry } from '@dxos/echo';
+import type { EntityNotFoundError } from '@dxos/echo/Err';
+import { FunctionNotFoundError } from './errors';
+import * as Operation from './Operation';
+/**
+ * Template input kind determines how template variables are resolved.
+ */
+export declare const InputKind: Schema.Literal<["value", "operation"]>;
+export type InputKind = Schema.Schema.Type<typeof InputKind>;
+/**
+ * Template input variable.
+ * E.g., {{foo}}
+ */
+export declare const Input: Schema.Struct<{
+    name: typeof Schema.String;
+    kind: Schema.Literal<["value", "operation"]>;
+    default: Schema.optional<typeof Schema.Any>;
+    /**
+     * Operation key invoked when `kind === 'operation'`. The referenced operation must accept void input —
+     * template inputs have no mechanism for passing arguments.
+     */
+    operation: Schema.optional<typeof Schema.String>;
+}>;
+export type Input = Schema.Schema.Type<typeof Input>;
+/**
+ * Template type.
+ */
+export declare const Template: Schema.Struct<{
+    source: Schema.SchemaClass<import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly content: string;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>, import("@dxos/echo-protocol").EncodedReference, never>;
+    /**
+     * NOTE: We use an array rather than map so that updating variable names in the template doesn't disconnect existing inputs.
+     */
+    inputs: Schema.optional<Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        kind: Schema.Literal<["value", "operation"]>;
+        default: Schema.optional<typeof Schema.Any>;
+        /**
+         * Operation key invoked when `kind === 'operation'`. The referenced operation must accept void input —
+         * template inputs have no mechanism for passing arguments.
+         */
+        operation: Schema.optional<typeof Schema.String>;
+    }>>>;
+}>;
+export type Template = Schema.Schema.Type<typeof Template>;
+export type MakeProps = Partial<{
+    id: string;
+    source: string;
+    inputs: Input[];
+}>;
+export declare const make: ({ id, source, inputs }?: MakeProps) => Template;
+/**
+ * Process Handlebars template.
+ */
+export declare const process: <Options extends {}>(source: string, variables?: Partial<Options>) => string;
+export declare const processTemplate: (template: Template) => Effect.Effect<string, EntityNotFoundError | FunctionNotFoundError, Registry.Service | Operation.Service>;
+//# sourceMappingURL=Template.d.ts.map

package/dist/types/src/Template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.d.ts","sourceRoot":"","sources":["../../../src/Template.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAA8B,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAM1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,SAAS,wCASrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;IAIhB;;;OAGG;;EAEH,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;IAGnB;;OAEG;;;;;QAjBH;;;WAGG;;;EAgBH,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC,CAAC;AAEjF,eAAO,MAAM,IAAI,4BAAiC,SAAS,KAAQ,QAGjE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,SAAS,EAAE,UAAU,MAAM,cAAa,OAAO,CAAC,OAAO,CAAC,KAAQ,MAQ9F,CAAC;AAEF,eAAO,MAAM,eAAe,aAChB,QAAQ,KACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAqCtG,CAAC"}

package/dist/types/src/Template.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Template.test.d.ts.map

package/dist/types/src/Template.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.test.d.ts","sourceRoot":"","sources":["../../../src/Template.test.ts"],"names":[],"mappings":""}