@agent-relay/agent 0.1.0

package/dist/policy.js

@@ -0,0 +1,152 @@
+export function createPolicyGate(options) {
+    return {
+        run: async (actionType, action, execute) => {
+            if (!options.policy) {
+                return await execute();
+            }
+            const mode = resolveActionMode(options.policy, actionType);
+            const id = globalThis.crypto.randomUUID();
+            const timestamp = new Date().toISOString();
+            if (mode === 'suggest') {
+                const suggestion = buildSuggestion(options, id, timestamp, actionType, action);
+                await writeAuditLog(options, suggestion.id, {
+                    id: suggestion.id,
+                    decision: suggestion.decision,
+                    actionType,
+                    workspace: options.workspace,
+                    agentId: options.agentId,
+                    createdAt: timestamp,
+                    action,
+                });
+                return suggestion;
+            }
+            if (mode === 'approval-required') {
+                if (typeof options.awaitApproval !== 'function') {
+                    throw new Error('policy approval flow is unavailable without a gateway approval coordinator');
+                }
+                await safeRelayfileWrite(options.relayfile, `/pending-approvals/${id}.json`, {
+                    id,
+                    workspace: options.workspace,
+                    agentId: options.agentId,
+                    actionType,
+                    createdAt: timestamp,
+                    action,
+                });
+                const verdict = normalizeApprovalVerdict(id, await options.awaitApproval(id));
+                try {
+                    await writeAuditLog(options, id, {
+                        id,
+                        decision: verdict.verdict === 'approved' ? 'approved' : 'rejected',
+                        actionType,
+                        workspace: options.workspace,
+                        agentId: options.agentId,
+                        createdAt: timestamp,
+                        approval: verdict.raw,
+                        action,
+                    });
+                }
+                finally {
+                    await safeRelayfileDelete(options.relayfile, `/pending-approvals/${id}.json`);
+                }
+                if (verdict.verdict !== 'approved') {
+                    throw new Error(verdict.reason?.trim()
+                        ? `policy approval rejected: ${verdict.reason.trim()}`
+                        : `policy approval rejected for ${actionType}`);
+                }
+                return await execute();
+            }
+            await writeAuditLog(options, id, {
+                id,
+                decision: 'auto',
+                actionType,
+                workspace: options.workspace,
+                agentId: options.agentId,
+                createdAt: timestamp,
+                action,
+            });
+            return await execute();
+        },
+    };
+}
+function resolveActionMode(policy, actionType) {
+    const mode = policy?.mode ?? 'auto';
+    if (policy?.approvals?.includes(actionType)) {
+        return 'approval-required';
+    }
+    return mode;
+}
+function buildSuggestion(options, id, createdAt, actionType, action) {
+    return {
+        id,
+        decision: 'suggested',
+        actionType,
+        workspace: options.workspace,
+        agentId: options.agentId,
+        createdAt,
+        action,
+    };
+}
+async function writeAuditLog(options, id, payload) {
+    await safeRelayfileWrite(options.relayfile, `/_policy-log/${options.workspace}/${id}.json`, payload);
+}
+async function safeRelayfileWrite(relayfile, path, body) {
+    try {
+        await relayfile.write(path, body);
+    }
+    catch (error) {
+        if (isUnavailableRelayfileError(error)) {
+            return;
+        }
+        throw error;
+    }
+}
+async function safeRelayfileDelete(relayfile, path) {
+    try {
+        await relayfile.delete(path);
+    }
+    catch (error) {
+        if (isUnavailableRelayfileError(error)) {
+            return;
+        }
+        throw error;
+    }
+}
+function isUnavailableRelayfileError(error) {
+    return error instanceof Error && error.message === 'relayfile control plane is not ready yet';
+}
+function normalizeApprovalVerdict(id, value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`approval ${id} returned an invalid verdict payload`);
+    }
+    const record = value;
+    const verdict = normalizeVerdict(record);
+    if (!verdict) {
+        throw new Error(`approval ${id} is missing a supported verdict`);
+    }
+    return {
+        id,
+        verdict,
+        approvedBy: typeof record.approvedBy === 'string' ? record.approvedBy : undefined,
+        reason: typeof record.reason === 'string' ? record.reason : undefined,
+        raw: record,
+    };
+}
+function normalizeVerdict(record) {
+    if (typeof record.verdict === 'string') {
+        const normalized = record.verdict.trim().toLowerCase();
+        if (normalized === 'approved' || normalized === 'approve') {
+            return 'approved';
+        }
+        if (normalized === 'rejected' ||
+            normalized === 'reject' ||
+            normalized === 'denied' ||
+            normalized === 'deny') {
+            return 'rejected';
+        }
+    }
+    if (typeof record.approved === 'boolean') {
+        return record.approved ? 'approved' : 'rejected';
+    }
+    return null;
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,387 @@
+import type { AgentEvent, LogFields, LogLevel, Logger, StructuredLogEntry } from '@agent-relay/events';
+/**
+ * Cron or one-shot trigger definition accepted by `agent()`.
+ */
+export type ScheduleSpec = string | {
+    cron: string;
+    tz?: string;
+} | {
+    at: string | Date;
+};
+/**
+ * Hosted-agent approval policy modes parsed from agent definitions.
+ */
+export type AgentPolicyMode = 'suggest' | 'auto' | 'approval-required';
+export type PolicyActionType = 'external-message' | 'write' | 'delete' | 'schedule';
+/**
+ * Action policy definition enforced by the agent context helpers.
+ */
+export interface AgentPolicy {
+    /** Approval mode to associate with the agent. */
+    mode: AgentPolicyMode;
+    /** Action classes that should require explicit approval before execution. */
+    approvals?: PolicyActionType[];
+}
+export interface AgentProviderConfig {
+    /** Whether hosted execution should use Relay-managed credentials or BYOK. */
+    mode: 'managed' | 'byok';
+    /** Secret reference used when `mode === "byok"`. */
+    secretRef?: string;
+}
+/**
+ * Replay bootstrap options reserved for M2 file triggers.
+ */
+export type ReplayOnStart = 'none' | `last:${number}` | `since:${string}`;
+/**
+ * Missed-tick policy for downtime recovery.
+ */
+export type CoalesceMissedTicksMode = 'drop' | 'fire-once';
+/**
+ * Runtime tuning options for the layered agent SDK.
+ */
+export interface AgentOptions {
+    /** Optional API key override. Falls back to `RELAY_API_KEY`. */
+    apiKey?: string;
+    /** Optional event gateway websocket URL. */
+    gatewayUrl?: string;
+    /** Optional direct relayfile base URL for local/offline helper calls. */
+    relayfileUrl?: string;
+    /** Optional direct relaycast base URL for local/offline helper calls. */
+    relaycastUrl?: string;
+    /** Deprecated HTTP scheduler base URL kept for compatibility with legacy tests. */
+    relaycronBaseUrl?: string;
+    /** Maximum number of concurrent handlers for the workspace. */
+    concurrency?: number;
+    /** Maximum queued backlog before the remote runtime should start dropping events. */
+    maxBacklog?: number;
+    /** Graceful shutdown drain timeout in milliseconds. Defaults to `30000`. */
+    drainMs?: number;
+    /** Per-handler timeout in milliseconds. Defaults to `300000`. */
+    handlerTimeoutMs?: number;
+    /** Whether SIGTERM and SIGINT should call `handle.stop()`. */
+    handleSignals?: boolean;
+    /** Replay bootstrap mode reserved for M2. `since:` values must be ISO-8601 timestamps. */
+    replayOnStart?: ReplayOnStart;
+    /** Default watch-event coalescing window in milliseconds. Defaults to `200`. */
+    coalesceMs?: number;
+    /** Missed-tick coalescing mode reserved for gateway enforcement. */
+    coalesceMissedTicks?: CoalesceMissedTicksMode;
+    /** Minimum structured log level emitted by `ctx.logger`. Defaults to `info`. */
+    logLevel?: LogLevel;
+}
+/**
+ * Workspace file materialized through the gateway relayfile proxy.
+ */
+export interface WorkspaceFile {
+    /** Workspace-relative or absolute path for the file. */
+    path: string;
+    /** Parsed file body when available. */
+    body: unknown;
+    /** Optional relayfile revision returned by the backend. */
+    revision?: string;
+    /** Optional content-type metadata. */
+    contentType?: string;
+    /** Optional text/binary encoding marker. */
+    encoding?: 'utf-8' | 'base64';
+    /** Optional relayfile semantics payload. */
+    semantics?: Record<string, unknown>;
+}
+/**
+ * Optional write metadata forwarded to the relayfile proxy.
+ */
+export interface WriteMeta {
+    /** Optional content-type override. */
+    contentType?: string;
+    /** Optional text/binary encoding marker. */
+    encoding?: 'utf-8' | 'base64';
+    /** Optional relayfile semantics payload. */
+    semantics?: Record<string, unknown>;
+    /** Optional compare-and-swap base revision. */
+    baseRevision?: string;
+    /** Optional idempotency identity forwarded to relayfile. */
+    contentIdentity?: {
+        kind: string;
+        key: string;
+    };
+}
+/**
+ * File list entry returned by the relayfile proxy.
+ */
+export interface FileSummary {
+    /** File path. */
+    path: string;
+    /** Optional node type. */
+    type?: 'file' | 'dir';
+    /** Optional relayfile revision. */
+    revision?: string;
+    /** Optional provider namespace. */
+    provider?: string;
+    /** Optional provider object id. */
+    providerObjectId?: string;
+    /** Optional size in bytes. */
+    size?: number;
+    /** Optional update timestamp. */
+    updatedAt?: string;
+    /** Optional projected property count. */
+    propertyCount?: number;
+    /** Optional projected relation count. */
+    relationCount?: number;
+    /** Optional projected permission count. */
+    permissionCount?: number;
+    /** Optional projected comment count. */
+    commentCount?: number;
+}
+/**
+ * Outbound relaycast message options.
+ */
+export interface PostOpts {
+    /** Optional application-level idempotency key. */
+    idempotencyKey?: string;
+}
+export type PolicyDecision = 'auto' | 'suggested' | 'approved' | 'rejected';
+export interface PolicySuggestion {
+    /** Stable policy event id used for audit and approval artifacts. */
+    id: string;
+    /** Decision produced by the policy gate. */
+    decision: 'suggested';
+    /** Action class evaluated by the gate. */
+    actionType: PolicyActionType;
+    /** Workspace associated with the action. */
+    workspace: string;
+    /** Agent associated with the action. */
+    agentId: string;
+    /** ISO timestamp when the suggestion was created. */
+    createdAt: string;
+    /** Structured action payload. */
+    action: Record<string, unknown>;
+}
+export interface ApprovalVerdictRecord {
+    /** Stable approval id matching `/pending-approvals/<id>.json`. */
+    id: string;
+    /** Human verdict value. */
+    verdict: 'approved' | 'rejected';
+    /** Optional approver metadata. */
+    approvedBy?: string;
+    /** Optional decision rationale. */
+    reason?: string;
+    /** Full raw payload written by the approver. */
+    raw: Record<string, unknown>;
+}
+/**
+ * Raw relayfile client surface exposed through `ctx.raw`.
+ */
+export interface RelayfileClient {
+    /** Whether the runtime has a live relayfile binding behind this client. */
+    available?: boolean;
+    /** Reads a workspace file. */
+    read(path: string): Promise<WorkspaceFile | null>;
+    /** Writes a workspace file. */
+    write(path: string, body: unknown, meta?: WriteMeta): Promise<void>;
+    /** Deletes a workspace file. */
+    delete(path: string): Promise<void>;
+    /** Lists files matching a glob. */
+    list(glob: string): Promise<FileSummary[]>;
+}
+/**
+ * Raw relaycast client surface exposed through `ctx.raw`.
+ */
+export interface RelaycastClient {
+    /** Whether the runtime has a live relaycast binding behind this client. */
+    available?: boolean;
+    /** Posts a message to a channel. */
+    post(channel: string, text: string, opts?: PostOpts): Promise<{
+        id: string;
+    } | PolicySuggestion>;
+    /** Replies to a thread. */
+    reply(threadId: string, text: string, opts?: PostOpts): Promise<{
+        id: string;
+    } | PolicySuggestion>;
+    /** Sends a direct message. */
+    dm(agentOrUser: string, text: string, opts?: PostOpts): Promise<{
+        id: string;
+    } | PolicySuggestion>;
+}
+/**
+ * Raw relaycron schedule registration payload.
+ */
+export interface RelaycronScheduleDefinition {
+    /** Cron expression for a recurring schedule. */
+    cron?: string;
+    /** ISO timestamp or `Date` for a one-shot schedule. */
+    at?: string | Date;
+    /** Optional timezone for recurring schedules. */
+    tz?: string;
+    /** Optional payload to associate with the schedule. */
+    payload?: unknown;
+}
+/**
+ * Schedule handle returned by the M1 relaycron wrapper.
+ */
+export interface RelaycronScheduleHandle {
+    /** Stable schedule identifier. */
+    id: string;
+}
+/**
+ * Raw relaycron client surface exposed through `ctx.raw`.
+ */
+export interface RelaycronClient {
+    /** Whether the runtime has a live relaycron binding behind this client. */
+    available?: boolean;
+    /** Registers a recurring or one-shot schedule. */
+    register(definition: RelaycronScheduleDefinition): Promise<RelaycronScheduleHandle>;
+    /** Cancels a schedule by id. */
+    cancel(id: string): Promise<void>;
+}
+/**
+ * Runtime context delivered to agent event handlers.
+ */
+export interface Context {
+    /** Workspace associated with the running agent. */
+    workspace: string;
+    /** Stable runtime agent identifier. */
+    agentId: string;
+    /** Structured logger surface. */
+    logger: Logger;
+    /** Handler-scoped abort signal for timeout and shutdown propagation. */
+    signal: AbortSignal;
+    /** Applies burn tagging to a fetch function or compatible LLM client. */
+    tagged<T>(value: T): T;
+    /** Relayfile helpers backed by the runtime gateway. */
+    files: {
+        /** Reads a workspace file. */
+        read(path: string): Promise<WorkspaceFile | null>;
+        /** Writes a workspace file. */
+        write(path: string, body: unknown, meta?: WriteMeta): Promise<void | PolicySuggestion>;
+        /** Deletes a workspace file. */
+        delete(path: string): Promise<void | PolicySuggestion>;
+        /** Lists matching files. */
+        list(glob: string): Promise<FileSummary[]>;
+    };
+    /** Relaycast helpers. */
+    messages: {
+        /** Posts a message to a channel. */
+        post(channel: string, text: string, opts?: PostOpts): Promise<{
+            id: string;
+        } | PolicySuggestion>;
+        /** Replies to an existing thread. */
+        reply(threadId: string, text: string, opts?: PostOpts): Promise<{
+            id: string;
+        } | PolicySuggestion>;
+        /** Sends a direct message to an agent or user. */
+        dm(agentOrUser: string, text: string, opts?: PostOpts): Promise<{
+            id: string;
+        } | PolicySuggestion>;
+    };
+    /** Relaycron helpers available in M1. */
+    schedule: {
+        /** Creates a one-shot wakeup. */
+        at(when: string | Date, payload?: unknown): Promise<{
+            id: string;
+        } | PolicySuggestion>;
+        /** Creates a recurring cron trigger. */
+        every(cron: string, payload?: unknown, opts?: {
+            tz?: string;
+        }): Promise<{
+            id: string;
+        } | PolicySuggestion>;
+        /** Cancels a previously created schedule. */
+        cancel(id: string): Promise<void | PolicySuggestion>;
+    };
+    /** Underlying raw primitive clients. */
+    raw: {
+        relayfile: RelayfileClient;
+        relaycron: RelaycronClient;
+        relaycast: RelaycastClient;
+    };
+    /** Application-level idempotency helper for non-event side effects. */
+    once<T>(key: string, fn: () => Promise<T>): Promise<T>;
+}
+/**
+ * Declarative agent definition for the layered SDK.
+ */
+export interface AgentDefinition {
+    /** Unified workspace name across runtime primitives. */
+    workspace: string;
+    /** Optional human-readable agent name. Defaults to the workspace. */
+    name?: string;
+    /** Optional time triggers. */
+    schedule?: ScheduleSpec | ScheduleSpec[];
+    /** Optional relayfile watch globs. */
+    watch?: string | string[];
+    /** Optional relaycast inbox subscriptions. */
+    inbox?: string | string[];
+    /** Single event handler for all normalized event types. */
+    onEvent: (ctx: Context, event: AgentEvent) => Promise<void> | void;
+    /** Optional startup hook invoked once the runtime is registered. */
+    onStart?: (ctx: Context) => Promise<void> | void;
+    /** Optional shutdown hook invoked during `handle.stop()`. */
+    onStop?: (ctx: Context) => Promise<void> | void;
+    /** Optional error hook for final delivery failures. */
+    onError?: (ctx: Context, error: Error, event: AgentEvent) => Promise<void> | void;
+    /** Action policy metadata enforced by the runtime helpers. */
+    policy?: AgentPolicy;
+    /** Hosted runtime model/provider configuration. */
+    provider?: AgentProviderConfig;
+    /** Runtime tuning options. */
+    options?: AgentOptions;
+}
+export type HostedAgentHandler = (ctx: Context, event: AgentEvent) => Promise<void> | void;
+/**
+ * Declarative hosted-agent definition accepted by `deployAgent(...)`.
+ */
+export interface HostedAgentDefinition {
+    /** Unified workspace name across runtime primitives. */
+    workspace: string;
+    /** Human-readable deployment name. */
+    name: string;
+    /** Hosted default runtime model identifier. */
+    model: string;
+    /** Hosted default runtime system instructions. */
+    instructions: string;
+    /** Optional time triggers. */
+    schedule?: ScheduleSpec | ScheduleSpec[];
+    /** Optional relayfile watch globs. */
+    watch?: string | string[];
+    /** Optional relaycast inbox subscriptions. */
+    inbox?: string | string[];
+    /** Optional custom runtime override for the managed sandbox. */
+    onEvent?: HostedAgentHandler;
+    /** Optional action policy metadata enforced by the runtime helpers. */
+    policy?: AgentPolicy;
+    /** Hosted runtime provider configuration. */
+    provider: AgentProviderConfig;
+}
+export interface HostedAgentStatus {
+    /** Stable runtime agent identifier. */
+    agentId: string;
+    /** Stable deployment identifier. */
+    deployId: string;
+    /** Current deployment state as reported by the control plane. */
+    state: string;
+    [key: string]: unknown;
+}
+export interface DeployHandle {
+    /** Stable runtime agent identifier. */
+    agentId: string;
+    /** Stable deployment identifier. */
+    deployId: string;
+    /** Reads the current control-plane deployment status. */
+    status(): Promise<HostedAgentStatus>;
+    /** Tears down the hosted deployment. */
+    undeploy(): Promise<void>;
+}
+/**
+ * Handle returned by `agent(...)`.
+ */
+export interface AgentHandle {
+    /** Resolves once the agent is registered and ready to receive events. */
+    ready: Promise<void>;
+    /** Stops the event stream, drains in-flight work, and tears down lifecycle hooks. */
+    stop(): Promise<void>;
+    /** Imperatively injects an event into the local dispatcher. */
+    trigger(event: Partial<AgentEvent>): Promise<void>;
+    /** Shared agent context outside an event scope. */
+    ctx: Context;
+}
+export type { LogFields, LogLevel, Logger, StructuredLogEntry };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@agent-relay/agent",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@agent-relay/events": "^0.1.0",
+    "@relaycast/sdk": "1.1.2",
+    "@relayfile/sdk": "^0.7.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.7.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/agent-relay-agent"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}