@onkeiki/agents 0.1.0

package/dist/Kit.d.ts

@@ -0,0 +1,138 @@
+import { Layer } from 'effect';
+import type { AgentKitConfig, AgentConfig } from './types/config.js';
+import type { AlertDefinition } from './Alert.js';
+import type { AgentKitPlugin, SyncPayload } from './Plugin.js';
+import type { PluginMigration } from './services/PluginDb.js';
+import type { InboundMessage } from './types/index.js';
+import type { ToolDefinition } from './Tool.js';
+export type AgentKitInstance = {
+    /**
+     * Sync local agent config + tools to the platform (infra-as-code).
+     * Pushes model, systemPrompt, tools, and execution mode to the platform DB.
+     */
+    readonly sync: () => Promise<void>;
+    /**
+     * Start the HTTP server that receives turn requests from the platform.
+     * Also calls sync() to push config to platform.
+     */
+    readonly serve: (opts?: {
+        port?: number;
+        host?: string;
+    }) => Promise<void>;
+    /**
+     * Process a single inbound message programmatically (useful for testing).
+     */
+    readonly handleInbound: (msg: InboundMessage) => Promise<{
+        response: string;
+        messageId: string;
+    }>;
+    /**
+     * Graceful shutdown.
+     */
+    readonly shutdown: () => Promise<void>;
+};
+/**
+ * @deprecated Use {@link AgentKitInstance} instead. Kept for backwards compatibility.
+ */
+export type SmsKitInstance = AgentKitInstance;
+/**
+ * Resolved plugin state — the merged result of all plugins.
+ * Used internally by Kit, Server, and sync.
+ */
+export type ResolvedPlugins = {
+    /** Agent config with plugin `init` contributions applied (explicit config wins). */
+    readonly agentConfig: AgentConfig;
+    /** Merged `PluginInitResult.extra` values, seeded into the sync payload's `extra`. */
+    readonly initExtra: Record<string, unknown>;
+    readonly tools: ReadonlyArray<ToolDefinition<any, any>>;
+    /** Alert definitions contributed by plugins, additive to `agent.alerts`. */
+    readonly alerts: ReadonlyArray<AlertDefinition>;
+    readonly routes: Readonly<Record<string, (req: Request, ctx: any) => Promise<Response>>>;
+    readonly hooks: {
+        readonly beforeTurn: ReadonlyArray<NonNullable<NonNullable<AgentKitPlugin['hooks']>['beforeTurn']>>;
+        readonly afterTurn: ReadonlyArray<NonNullable<NonNullable<AgentKitPlugin['hooks']>['afterTurn']>>;
+        readonly beforeToolCall: ReadonlyArray<NonNullable<NonNullable<AgentKitPlugin['hooks']>['beforeToolCall']>>;
+        readonly afterToolCall: ReadonlyArray<NonNullable<NonNullable<AgentKitPlugin['hooks']>['afterToolCall']>>;
+    };
+    readonly layers: ReadonlyArray<Layer.Layer<any>>;
+    readonly onSync: ReadonlyArray<NonNullable<AgentKitPlugin['onSync']>>;
+    readonly onRequest: ReadonlyArray<NonNullable<AgentKitPlugin['onRequest']>>;
+    readonly onResponse: ReadonlyArray<NonNullable<AgentKitPlugin['onResponse']>>;
+    readonly middleware: ReadonlyArray<NonNullable<AgentKitPlugin['middleware']>[number]>;
+    readonly migrations: ReadonlyArray<{
+        readonly pluginId: string;
+        readonly migrations: ReadonlyArray<PluginMigration>;
+    }>;
+};
+/**
+ * Merge a plugin's `init` config contribution into the agent config.
+ * Explicitly-set agent config keys always win over plugin defaults.
+ */
+export declare function applyPluginConfig(agent: AgentConfig, overrides: Partial<AgentConfig>): AgentConfig;
+/**
+ * Resolve all plugins into a single merged structure.
+ */
+export declare function resolvePlugins(config: AgentKitConfig): ResolvedPlugins;
+/**
+ * The agent's own alerts plus plugin-contributed ones, deduped by name
+ * (first definition wins, so agent config beats plugins). Used by both
+ * alert registration in `sync` and the `/alerts/execute` handler so the
+ * two cannot diverge.
+ */
+export declare function mergedAlerts(config: AgentKitConfig, resolved: ResolvedPlugins): AlertDefinition[];
+/**
+ * Run all plugin `onSync` hooks over the initial sync payload.
+ */
+export declare function applySyncHooks(initial: SyncPayload, hooks: ReadonlyArray<NonNullable<AgentKitPlugin['onSync']>>): SyncPayload;
+/**
+ * Create an AgentKit instance from config.
+ *
+ * @example
+ * ```ts
+ * import { AgentKit } from '@onkeiki/agents'
+ * import { PostgresStorageLive } from '@onkeiki/agents-storage-postgres'
+ * import { memory, browser, steering } from '@onkeiki/agents-plugins'
+ *
+ * const kit = AgentKit.create({
+ *   apiKey: process.env.KEIKI_API_KEY!,
+ *   name: 'My Agent',
+ *   resolveNumber: (ctx) => Effect.succeed('+14155551234'),
+ *   storage: PostgresStorageLive({ connectionString: process.env.DATABASE_URL! }),
+ *   plugins: [
+ *     memory({ provider: 'supermemory', autoRetrieve: true }),
+ *     browser({ handoff: true }),
+ *     steering({ debounceWindow: '2 seconds', midTurnStrategy: 'interrupt' }),
+ *   ],
+ *   agent: {
+ *     model: 'google/gemini-3.5-flash',
+ *     maxSteps: 10,
+ *     historyLimit: 40,
+ *     systemPrompt: ({ user }) => `You are an assistant for ${user.phone}`,
+ *     tools: [],
+ *   },
+ * })
+ *
+ * kit.serve({ port: 8789 })
+ * ```
+ */
+export declare const AgentKit: {
+    create(config: AgentKitConfig): AgentKitInstance;
+};
+/**
+ * @deprecated Use {@link AgentKit} instead. Kept for backwards compatibility.
+ */
+export declare const SmsKit: {
+    create(config: AgentKitConfig): AgentKitInstance;
+};
+/**
+ * Channel-neutral alias of `AgentKit.create()`.
+ *
+ * @example
+ * ```ts
+ * import { create } from '@onkeiki/agents'
+ *
+ * const kit = create({ ... })
+ * ```
+ */
+export declare const create: (config: AgentKitConfig) => AgentKitInstance;
+//# sourceMappingURL=Kit.d.ts.map

package/dist/Kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kit.d.ts","sourceRoot":"","sources":["../src/Kit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAgC,MAAM,QAAQ,CAAA;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAA;AAGnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAM7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAElC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1E;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEjG;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;IACvD,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC/C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IACxF,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACnG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;QACjG,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAA;QAC3G,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;KAC1G,CAAA;IACD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IACrE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;IAC3E,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC7E,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IACrF,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;KAAE,CAAC,CAAA;CACvH,CAAA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAKlG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAgEtE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,GAAG,eAAe,EAAE,CAOjG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,GAC1D,WAAW,CAMb;AA0ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,QAAQ;IACnB,MAAM,SAAS,cAAc,GAAG,gBAAgB;CAyDjD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;mBA9DF,cAAc,GAAG,gBAAgB;CA8DpB,CAAA;AAE9B;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,WAAY,cAAc,KAAG,gBAA2C,CAAA"}

package/dist/Kit.js

@@ -0,0 +1,517 @@
+import { Effect, Layer, Queue, Ref, pipe, JSONSchema } from 'effect';
+import { StorageError } from './services/Storage.js';
+import { Storage } from './services/Storage.js';
+import { Platform, PlatformError } from './services/Platform.js';
+import { Steering } from './services/Steering.js';
+import { Blackboard } from './services/Blackboard.js';
+import { bundleTool } from './bundle.js';
+/**
+ * Merge a plugin's `init` config contribution into the agent config.
+ * Explicitly-set agent config keys always win over plugin defaults.
+ */
+export function applyPluginConfig(agent, overrides) {
+    const explicit = Object.fromEntries(Object.entries(agent).filter(([, value]) => value !== undefined));
+    return { ...agent, ...overrides, ...explicit };
+}
+/**
+ * Resolve all plugins into a single merged structure.
+ */
+export function resolvePlugins(config) {
+    const plugins = config.plugins ?? [];
+    let agentConfig = config.agent;
+    const initExtra = {};
+    const tools = [];
+    const routes = {};
+    const beforeTurn = [];
+    const afterTurn = [];
+    const beforeToolCall = [];
+    const afterToolCall = [];
+    const layers = [];
+    const onSync = [];
+    const onRequest = [];
+    const onResponse = [];
+    const middleware = [];
+    const migrations = [];
+    const alerts = [];
+    for (const plugin of plugins) {
+        // Run init — may contribute config overrides (not mutating original).
+        // Later plugins see earlier plugins' contributions.
+        const ctx = { config, agentConfig };
+        const initResult = plugin.init?.(ctx);
+        if (initResult?.config) {
+            agentConfig = applyPluginConfig(agentConfig, initResult.config);
+        }
+        if (initResult?.extra) {
+            Object.assign(initExtra, initResult.extra);
+        }
+        // Collect static migrations declared on the plugin
+        if (plugin.migrations && plugin.migrations.length > 0) {
+            migrations.push({ pluginId: plugin.id, migrations: plugin.migrations });
+        }
+        if (plugin.tools)
+            tools.push(...plugin.tools);
+        if (plugin.alerts)
+            alerts.push(...plugin.alerts);
+        if (plugin.routes)
+            Object.assign(routes, plugin.routes);
+        if (plugin.hooks?.beforeTurn)
+            beforeTurn.push(plugin.hooks.beforeTurn);
+        if (plugin.hooks?.afterTurn)
+            afterTurn.push(plugin.hooks.afterTurn);
+        if (plugin.hooks?.beforeToolCall)
+            beforeToolCall.push(plugin.hooks.beforeToolCall);
+        if (plugin.hooks?.afterToolCall)
+            afterToolCall.push(plugin.hooks.afterToolCall);
+        if (plugin.layers)
+            layers.push(...plugin.layers);
+        if (plugin.onSync)
+            onSync.push(plugin.onSync);
+        if (plugin.onRequest)
+            onRequest.push(plugin.onRequest);
+        if (plugin.onResponse)
+            onResponse.push(plugin.onResponse);
+        if (plugin.middleware)
+            middleware.push(...plugin.middleware);
+    }
+    return {
+        agentConfig,
+        initExtra,
+        tools,
+        alerts,
+        routes,
+        hooks: { beforeTurn, afterTurn, beforeToolCall, afterToolCall },
+        layers,
+        onSync,
+        onRequest,
+        onResponse,
+        middleware,
+        migrations,
+    };
+}
+/**
+ * The agent's own alerts plus plugin-contributed ones, deduped by name
+ * (first definition wins, so agent config beats plugins). Used by both
+ * alert registration in `sync` and the `/alerts/execute` handler so the
+ * two cannot diverge.
+ */
+export function mergedAlerts(config, resolved) {
+    const seen = new Set();
+    return [...(config.agent.alerts ?? []), ...resolved.alerts].filter((a) => {
+        if (seen.has(a.name))
+            return false;
+        seen.add(a.name);
+        return true;
+    });
+}
+/**
+ * Run all plugin `onSync` hooks over the initial sync payload.
+ */
+export function applySyncHooks(initial, hooks) {
+    let payload = initial;
+    for (const onSync of hooks) {
+        payload = onSync(payload);
+    }
+    return payload;
+}
+function isStorageBundle(s) {
+    return 'layer' in s && 'pluginDb' in s;
+}
+/** Cloud agents keep history and users on the platform; every local storage call fails loudly. */
+const NoStorage = Layer.succeed(Storage, new Proxy({}, {
+    get: (_, method) => () => Effect.fail(new StorageError(`Storage.${String(method)} called but no \`storage\` was passed to AgentKit.create`)),
+}));
+function unwrapStorage(config) {
+    if (!config.storage)
+        return { layer: NoStorage, pluginDb: undefined };
+    if (isStorageBundle(config.storage)) {
+        return { layer: config.storage.layer, pluginDb: config.storage.pluginDb };
+    }
+    return { layer: config.storage, pluginDb: undefined };
+}
+/**
+ * Run plugin-owned migrations using the configured PluginDb.
+ * Each plugin's migrations are tracked in `smskit_plugin_migrations`.
+ * Migrations are additive only — tables are NEVER dropped when a plugin is disabled.
+ */
+async function runPluginMigrations(pluginDb, migrations) {
+    if (migrations.length === 0 || !pluginDb)
+        return;
+    const db = pluginDb;
+    await Effect.runPromise(db.execute(`
+      CREATE TABLE IF NOT EXISTS smskit_plugin_migrations (
+        plugin_id  TEXT NOT NULL,
+        version    INT NOT NULL,
+        name       TEXT NOT NULL,
+        applied_at TIMESTAMPTZ DEFAULT now(),
+        PRIMARY KEY (plugin_id, version)
+      )
+    `));
+    for (const { pluginId, pluginMigrations } of migrations.map((m) => ({ pluginId: m.pluginId, pluginMigrations: m.migrations }))) {
+        const applied = await Effect.runPromise(db.query(`SELECT version FROM smskit_plugin_migrations WHERE plugin_id = $1 ORDER BY version`, [pluginId]));
+        const appliedSet = new Set(applied.map((r) => r.version));
+        for (const migration of [...pluginMigrations].sort((a, b) => a.version - b.version)) {
+            if (appliedSet.has(migration.version))
+                continue;
+            await Effect.runPromise(db.execute(migration.up));
+            await Effect.runPromise(db.execute(`INSERT INTO smskit_plugin_migrations (plugin_id, version, name) VALUES ($1, $2, $3)`, [pluginId, migration.version, migration.name]));
+        }
+    }
+}
+/**
+ * Create an AgentKit instance from config.
+ *
+ * @example
+ * ```ts
+ * import { AgentKit } from '@onkeiki/agents'
+ * import { PostgresStorageLive } from '@onkeiki/agents-storage-postgres'
+ * import { memory, browser, steering } from '@onkeiki/agents-plugins'
+ *
+ * const kit = AgentKit.create({
+ *   apiKey: process.env.KEIKI_API_KEY!,
+ *   name: 'My Agent',
+ *   resolveNumber: (ctx) => Effect.succeed('+14155551234'),
+ *   storage: PostgresStorageLive({ connectionString: process.env.DATABASE_URL! }),
+ *   plugins: [
+ *     memory({ provider: 'supermemory', autoRetrieve: true }),
+ *     browser({ handoff: true }),
+ *     steering({ debounceWindow: '2 seconds', midTurnStrategy: 'interrupt' }),
+ *   ],
+ *   agent: {
+ *     model: 'google/gemini-3.5-flash',
+ *     maxSteps: 10,
+ *     historyLimit: 40,
+ *     systemPrompt: ({ user }) => `You are an assistant for ${user.phone}`,
+ *     tools: [],
+ *   },
+ * })
+ *
+ * kit.serve({ port: 8789 })
+ * ```
+ */
+export const AgentKit = {
+    create(config) {
+        const resolved = resolvePlugins(config);
+        const effectiveConfig = { ...config, agent: resolved.agentConfig };
+        const { layer: storageLayer, pluginDb } = unwrapStorage(effectiveConfig);
+        const platformLayer = makePlatformLayer(effectiveConfig);
+        const steeringLayer = makeSteeringLayer(effectiveConfig.agent);
+        const blackboardLayer = makeBlackboardLayer();
+        const fullLayer = pipe(storageLayer, Layer.merge(platformLayer), Layer.merge(steeringLayer), Layer.merge(blackboardLayer));
+        return {
+            sync: async () => {
+                await runPluginMigrations(pluginDb, resolved.migrations);
+                await syncToPlatform(effectiveConfig, resolved);
+            },
+            serve: async (opts) => {
+                const port = opts?.port ?? 8789;
+                const host = opts?.host ?? '0.0.0.0';
+                // Start server first so it's ready to receive turns
+                const { createServer } = await import('./Server.js');
+                const server = createServer(effectiveConfig, resolved);
+                Bun.serve({
+                    port,
+                    hostname: host,
+                    fetch: server.fetch,
+                });
+                console.log(`@onkeiki/agents serving on ${host}:${port}`);
+                // Run plugin migrations and sync config
+                await runPluginMigrations(pluginDb, resolved.migrations);
+                await syncToPlatform(effectiveConfig, resolved, port);
+            },
+            handleInbound: async (msg) => {
+                return Effect.runPromise(Effect.gen(function* () {
+                    const steering = yield* Steering;
+                    yield* steering.enqueue(msg);
+                    return { response: '', messageId: '' };
+                }).pipe(Effect.provide(fullLayer)));
+            },
+            shutdown: async () => {
+                console.log('@onkeiki/agents shutting down');
+            },
+        };
+    },
+};
+/**
+ * @deprecated Use {@link AgentKit} instead. Kept for backwards compatibility.
+ */
+export const SmsKit = AgentKit;
+/**
+ * Channel-neutral alias of `AgentKit.create()`.
+ *
+ * @example
+ * ```ts
+ * import { create } from '@onkeiki/agents'
+ *
+ * const kit = create({ ... })
+ * ```
+ */
+export const create = (config) => AgentKit.create(config);
+// --- Internal helpers ---
+function platformFetch(config, path, body) {
+    return Effect.tryPromise({
+        try: async () => {
+            const res = await fetch(`${getPlatformUrl()}${path}`, {
+                method: body ? 'POST' : 'GET',
+                headers: {
+                    'Authorization': `Bearer ${config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                ...(body ? { body: JSON.stringify(body) } : {}),
+            });
+            if (!res.ok) {
+                throw new Error(`Platform API error ${res.status}: ${await res.text()}`);
+            }
+            return await res.json();
+        },
+        catch: (e) => new PlatformError(String(e), e),
+    });
+}
+function makePlatformLayer(config) {
+    return Layer.succeed(Platform, {
+        memoryRecall: (phone, query, opts) => platformFetch(config, '/v1/memory/recall', { phone, query, ...opts }).pipe(Effect.map((r) => r.facts ?? [])),
+        memoryLearn: (phone, facts) => platformFetch(config, '/v1/memory/learn', { phone, facts }).pipe(Effect.asVoid),
+        browse: (instruction, opts) => platformFetch(config, '/v1/browser/browse', { instruction, ...opts }),
+        handoff: (opts) => platformFetch(config, '/v1/browser/handoff', opts),
+        exec: (command, opts) => platformFetch(config, '/v1/sandbox/exec', { command, ...opts }),
+        writeFile: (path, content, opts) => platformFetch(config, '/v1/sandbox/write', { path, content, ...opts }).pipe(Effect.asVoid),
+        readFile: (path, opts) => platformFetch(config, '/v1/sandbox/read', { path, ...opts }).pipe(Effect.map((r) => r.content)),
+        runJob: (opts) => platformFetch(config, '/v1/executor/run', opts),
+        getJobStatus: (jobId) => platformFetch(config, `/v1/executor/status/${jobId}`),
+        escalate: (opts) => platformFetch(config, '/v1/escalation/create', opts),
+        extractFacts: (phone, messages) => platformFetch(config, '/v1/learning/extract', { phone, messages }).pipe(Effect.map((r) => r.facts ?? [])),
+        transcribeAudio: (url) => platformFetch(config, '/v1/media/transcribe', { url }).pipe(Effect.map((r) => r.text)),
+        describeImage: (url, prompt) => platformFetch(config, '/v1/media/describe', { url, prompt }).pipe(Effect.map((r) => r.description)),
+        extractDocument: (url) => platformFetch(config, '/v1/media/extract-document', { url }).pipe(Effect.map((r) => r.content)),
+    });
+}
+function makeSteeringLayer(agent) {
+    return Layer.effect(Steering, Effect.gen(function* () {
+        const decisionQueue = yield* Queue.unbounded();
+        const states = yield* Ref.make(new Map());
+        return {
+            enqueue: (msg) => Effect.gen(function* () {
+                const stateMap = yield* Ref.get(states);
+                const existing = stateMap.get(msg.phone);
+                if (!existing || existing.status === 'idle') {
+                    yield* Ref.update(states, (m) => {
+                        const updated = new Map(m);
+                        updated.set(msg.phone, { phone: msg.phone, status: 'debouncing', pending: [msg] });
+                        return updated;
+                    });
+                }
+                else if (existing.status === 'debouncing') {
+                    yield* Ref.update(states, (m) => {
+                        const updated = new Map(m);
+                        updated.set(msg.phone, { ...existing, pending: [...existing.pending, msg] });
+                        return updated;
+                    });
+                }
+                else if (existing.status === 'processing') {
+                    const strategy = agent.steering?.midTurnStrategy ?? 'append';
+                    if (strategy === 'interrupt') {
+                        yield* Queue.offer(decisionQueue, { type: 'interrupt', messages: [msg] });
+                    }
+                    else {
+                        yield* Queue.offer(decisionQueue, { type: 'append', message: msg });
+                    }
+                }
+            }),
+            decisions: Effect.succeed(decisionQueue),
+            turnCompleted: (phone) => Ref.update(states, (m) => {
+                const updated = new Map(m);
+                updated.set(phone, { phone, status: 'idle', pending: [] });
+                return updated;
+            }),
+            getState: (phone) => Ref.get(states).pipe(Effect.map((m) => m.get(phone) ?? { phone, status: 'idle', pending: [] })),
+        };
+    }));
+}
+function makeBlackboardLayer() {
+    return Layer.effect(Blackboard, Effect.gen(function* () {
+        const store = yield* Ref.make(new Map());
+        return {
+            read: (key) => Ref.get(store).pipe(Effect.map((m) => m.get(key) ?? null)),
+            write: (key, value) => Ref.update(store, (m) => { const n = new Map(m); n.set(key, value); return n; }),
+            delete: (key) => Ref.update(store, (m) => { const n = new Map(m); n.delete(key); return n; }),
+            entries: () => Ref.get(store).pipe(Effect.map((m) => [...m.entries()])),
+            clear: () => Ref.set(store, new Map()),
+        };
+    }));
+}
+/**
+ * Sync local agent config + tools + alerts + secrets to the platform (infra-as-code).
+ */
+async function syncToPlatform(config, resolved, port) {
+    const platformUrl = getPlatformUrl();
+    console.log(`[agents] Syncing to platform at ${platformUrl}`);
+    const headers = {
+        'Authorization': `Bearer ${config.apiKey}`,
+        'Content-Type': 'application/json',
+    };
+    // Build a static system prompt for platform storage
+    const staticPrompt = config.agent.systemPrompt({
+        user: { phone: '', timezone: null, currency: null, metadata: {}, firstSeenAt: new Date() },
+        now: new Date(),
+        phone: '',
+        context: { memorySummary: null, relevantFacts: [] },
+        isFirstInteraction: false,
+        history: [],
+        staticSync: true,
+    });
+    // Merge agent tools + plugin tools
+    const allTools = [...config.agent.tools, ...resolved.tools];
+    // Build tool definitions for the sync payload
+    const isSdkMode = port !== undefined;
+    const toolDefs = await Promise.all(allTools.map(async (tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: JSONSchema.make(tool.input),
+        executionType: 'code',
+        code: isSdkMode ? null : await bundleTool(tool),
+    })));
+    // Derive features flags from agent config
+    const features = {
+        memory: !!config.agent.memory?.enabled,
+        browser: !!config.agent.browser?.enabled,
+        sandbox: !!config.agent.sandbox?.enabled,
+        executor: !!config.agent.executor?.enabled,
+        mcp: !!config.agent.mcp?.enabled,
+        blackboard: !!config.agent.blackboard,
+        promptCache: !!config.agent.promptCache,
+        escalation: !!config.agent.escalation?.enabled,
+        steering: !!config.agent.steering,
+        media: !!config.agent.media,
+        loops: !!config.agent.loops?.enabled,
+    };
+    const loopPresets = (config.agent.loops?.presets ?? []).map((p) => ({
+        name: p.name,
+        description: p.description,
+        prompt: p.prompt,
+        schedule_type: p.scheduleType,
+        schedule_expression: p.scheduleExpression,
+        timezone: p.timezone ?? null,
+        quiet: p.quiet ?? false,
+    }));
+    const userConnections = (config.agent.mcp?.userConnections ?? []).map((c) => ({
+        name: c.name,
+        description: c.description ?? null,
+        aliases: c.aliases ?? [],
+        vendor: c.vendor ?? null,
+        capabilities: c.capabilities ?? [],
+        spec: c.spec,
+        base_url: c.baseUrl ?? null,
+        oauth: {
+            authorization_url: c.oauth.authorizationUrl,
+            token_url: c.oauth.tokenUrl,
+            client_id_secret: c.oauth.clientIdSecret,
+            client_secret_secret: c.oauth.clientSecretSecret,
+        },
+        health_check: c.healthCheck
+            ? {
+                operation: c.healthCheck.operation,
+                args: c.healthCheck.args ?? null,
+                identity_field: c.healthCheck.identityField ?? null,
+            }
+            : null,
+    }));
+    // Single atomic sync call
+    const syncBody = {
+        name: config.name,
+        model: config.agent.model,
+        max_steps: config.agent.maxSteps,
+        history_limit: config.agent.historyLimit,
+        system_prompt: staticPrompt,
+        execution_mode: port ? 'sdk' : 'platform',
+        webhook_url: port ? `http://localhost:${port}` : undefined,
+        harness: config.harness?.type ?? 'flue',
+        harness_config: config.harness ? {
+            mode: config.harness.connectivity,
+            dispatchUrl: config.harness.dispatchUrl,
+            timeoutMs: config.harness.timeoutMs === undefined
+                ? undefined
+                : durationInputToMs(config.harness.timeoutMs),
+        } : undefined,
+        features,
+        loop_presets: loopPresets,
+        user_connections: userConnections,
+        capabilities: config.agent.capabilities ?? undefined,
+        tools: toolDefs,
+    };
+    // Let plugins augment the sync payload
+    const payload = applySyncHooks({
+        name: syncBody.name,
+        model: syncBody.model,
+        tools: toolDefs.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
+        features,
+        extra: { ...resolved.initExtra },
+    }, resolved.onSync);
+    const syncRes = await fetch(`${platformUrl}/api/v1/developer/sync`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({
+            ...syncBody,
+            name: payload.name,
+            model: payload.model,
+            features: payload.features,
+            extra: payload.extra,
+        }),
+    });
+    let devAgentId;
+    if (!syncRes.ok) {
+        console.warn(`[agents] Sync failed: ${syncRes.status} ${await syncRes.text()}`);
+    }
+    else {
+        const result = await syncRes.json();
+        devAgentId = result.devAgentId;
+        console.log(`[agents] Sync complete: agent="${config.name}" id=${devAgentId} tools=${allTools.length}`);
+    }
+    // Sync alerts (if any defined) — the agent's own plus plugin-contributed.
+    const alerts = mergedAlerts(config, resolved);
+    if (alerts.length > 0) {
+        const alertDefs = alerts.map((alert) => ({
+            name: alert.name,
+            description: alert.description,
+            schedule: alert.schedule,
+        }));
+        const alertsRes = await fetch(`${platformUrl}/api/v1/developer/alerts/sync`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ devAgentId, alerts: alertDefs }),
+        });
+        if (!alertsRes.ok) {
+            console.warn(`[agents] Alerts sync failed: ${alertsRes.status} ${await alertsRes.text()}`);
+        }
+        else {
+            console.log(`[agents] Alerts synced: ${alerts.length} alert(s)`);
+        }
+    }
+    // Sync secrets (if any defined)
+    if (config.secrets && Object.keys(config.secrets).length > 0) {
+        const secretsRes = await fetch(`${platformUrl}/api/v1/developer/secrets/sync`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ secrets: config.secrets }),
+        });
+        if (!secretsRes.ok) {
+            console.warn(`[agents] Secrets sync failed: ${secretsRes.status} ${await secretsRes.text()}`);
+        }
+        else {
+            console.log(`[agents] Secrets synced: ${Object.keys(config.secrets).length} secret(s)`);
+        }
+    }
+}
+function durationInputToMs(value) {
+    if (typeof value === 'number')
+        return value;
+    const [amountText, unit] = value.split(' ');
+    const amount = Number(amountText);
+    if (unit === 'hours')
+        return amount * 3_600_000;
+    if (unit === 'minutes')
+        return amount * 60_000;
+    return amount * 1_000;
+}
+function getPlatformUrl() {
+    return process.env.KEIKI_PLATFORM_URL ?? 'https://smskit-production.up.railway.app';
+}
+//# sourceMappingURL=Kit.js.map