@agent-relay/sdk 7.1.1 → 8.0.2

package/dist/actions/json-schema-lite.js

@@ -0,0 +1,322 @@
+/**
+ * Resolve Node's `createRequire` without a static `node:module` import, so
+ * browser/edge bundles don't fail to resolve it. Returns `undefined` off Node
+ * (or on Node versions without `process.getBuiltinModule`).
+ */
+function nodeCreateRequire() {
+    const proc = globalThis.process;
+    const mod = proc?.getBuiltinModule?.('node:module');
+    return mod?.createRequire;
+}
+export function validateJsonSchemaLite(value, schema) {
+    if (schema === undefined || schema === true) {
+        return { valid: true, issues: [] };
+    }
+    const state = { issues: [] };
+    validateAgainstSchema(value, schema, '$', state);
+    return { valid: state.issues.length === 0, issues: state.issues };
+}
+function validateAgainstSchema(value, schema, path, state) {
+    if (schema === true) {
+        return;
+    }
+    if (schema === false) {
+        addIssue(state, path, 'value is not allowed', 'never', describeValue(value));
+        return;
+    }
+    if (!isSchemaObject(schema)) {
+        addIssue(state, path, 'schema must be a boolean or object', 'schema', describeValue(schema));
+        return;
+    }
+    validateCombinators(value, schema, path, state);
+    if (schema.const !== undefined && !jsonEqual(value, schema.const)) {
+        addIssue(state, path, `expected const ${JSON.stringify(schema.const)}`, JSON.stringify(schema.const), describeValue(value));
+    }
+    if (schema.enum && !schema.enum.some((candidate) => jsonEqual(value, candidate))) {
+        addIssue(state, path, `expected one of ${schema.enum.map((candidate) => JSON.stringify(candidate)).join(', ')}`);
+    }
+    const types = getExpectedTypes(schema);
+    if (types.length > 0 && !types.some((type) => matchesType(value, type))) {
+        addIssue(state, path, `expected ${types.join(' or ')}`, types.join(' or '), describeValue(value));
+        return;
+    }
+    if (shouldValidateObject(value, schema)) {
+        validateObject(value, schema, path, state);
+    }
+    if (shouldValidateArray(value, schema)) {
+        validateArray(value, schema, path, state);
+    }
+    if (typeof value === 'string') {
+        validateString(value, schema, path, state);
+    }
+    if (typeof value === 'number') {
+        validateNumber(value, schema, path, state);
+    }
+}
+function validateCombinators(value, schema, path, state) {
+    if (schema.allOf) {
+        for (const child of schema.allOf) {
+            validateAgainstSchema(value, child, path, state);
+        }
+    }
+    if (schema.anyOf) {
+        const matched = schema.anyOf.some((child) => validateJsonSchemaLite(value, child).valid);
+        if (!matched) {
+            addIssue(state, path, 'expected value to match at least one anyOf schema');
+        }
+    }
+    if (schema.oneOf) {
+        const matches = schema.oneOf.filter((child) => validateJsonSchemaLite(value, child).valid).length;
+        if (matches !== 1) {
+            addIssue(state, path, `expected value to match exactly one oneOf schema, matched ${matches}`);
+        }
+    }
+}
+function validateObject(value, schema, path, state) {
+    for (const key of schema.required ?? []) {
+        if (!Object.prototype.hasOwnProperty.call(value, key)) {
+            addIssue(state, appendPath(path, key), 'required property is missing');
+        }
+    }
+    const properties = schema.properties ?? {};
+    for (const [key, childSchema] of Object.entries(properties)) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+            validateAgainstSchema(value[key], childSchema, appendPath(path, key), state);
+        }
+    }
+    const additional = schema.additionalProperties;
+    if (additional === undefined || additional === true) {
+        return;
+    }
+    for (const key of Object.keys(value)) {
+        if (Object.prototype.hasOwnProperty.call(properties, key)) {
+            continue;
+        }
+        if (additional === false) {
+            addIssue(state, appendPath(path, key), 'additional property is not allowed');
+        }
+        else {
+            validateAgainstSchema(value[key], additional, appendPath(path, key), state);
+        }
+    }
+}
+function validateArray(value, schema, path, state) {
+    if (schema.minItems !== undefined && value.length < schema.minItems) {
+        addIssue(state, path, `expected at least ${schema.minItems} items`);
+    }
+    if (schema.maxItems !== undefined && value.length > schema.maxItems) {
+        addIssue(state, path, `expected at most ${schema.maxItems} items`);
+    }
+    if (schema.items !== undefined) {
+        value.forEach((item, index) => {
+            validateAgainstSchema(item, schema.items, `${path}[${index}]`, state);
+        });
+    }
+}
+function validateString(value, schema, path, state) {
+    if (schema.minLength !== undefined && value.length < schema.minLength) {
+        addIssue(state, path, `expected length >= ${schema.minLength}`);
+    }
+    if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+        addIssue(state, path, `expected length <= ${schema.maxLength}`);
+    }
+    if (schema.pattern !== undefined) {
+        try {
+            if (!new RegExp(schema.pattern).test(value)) {
+                addIssue(state, path, `expected string to match /${schema.pattern}/`);
+            }
+        }
+        catch {
+            addIssue(state, path, `invalid pattern /${schema.pattern}/`);
+        }
+    }
+}
+function validateNumber(value, schema, path, state) {
+    if (schema.minimum !== undefined && value < schema.minimum) {
+        addIssue(state, path, `expected value >= ${schema.minimum}`);
+    }
+    if (schema.maximum !== undefined && value > schema.maximum) {
+        addIssue(state, path, `expected value <= ${schema.maximum}`);
+    }
+}
+function getExpectedTypes(schema) {
+    if (Array.isArray(schema.type)) {
+        return schema.type;
+    }
+    if (schema.type) {
+        return [schema.type];
+    }
+    if (schema.properties || schema.required || schema.additionalProperties !== undefined) {
+        return ['object'];
+    }
+    if (schema.items || schema.minItems !== undefined || schema.maxItems !== undefined) {
+        return ['array'];
+    }
+    return [];
+}
+function matchesType(value, type) {
+    switch (type) {
+        case 'array':
+            return Array.isArray(value);
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'integer':
+            return Number.isInteger(value);
+        case 'null':
+            return value === null;
+        case 'number':
+            return typeof value === 'number' && Number.isFinite(value);
+        case 'object':
+            return isPlainObject(value);
+        case 'string':
+            return typeof value === 'string';
+    }
+    return false;
+}
+function shouldValidateObject(value, schema) {
+    return (isPlainObject(value) &&
+        Boolean(schema.properties || schema.required || schema.additionalProperties !== undefined));
+}
+function shouldValidateArray(value, schema) {
+    return (Array.isArray(value) &&
+        Boolean(schema.items || schema.minItems !== undefined || schema.maxItems !== undefined));
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isSchemaObject(value) {
+    return isPlainObject(value);
+}
+function appendPath(path, key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? `${path}.${key}` : `${path}[${JSON.stringify(key)}]`;
+}
+function addIssue(state, path, message, expected, received) {
+    state.issues.push({
+        path,
+        message,
+        ...(expected !== undefined ? { expected } : {}),
+        ...(received !== undefined ? { received } : {}),
+    });
+}
+function describeValue(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    return typeof value;
+}
+function jsonEqual(left, right) {
+    if (left === right) {
+        return true;
+    }
+    if (Array.isArray(left) && Array.isArray(right)) {
+        return (left.length === right.length && left.every((item, index) => jsonEqual(item, right[index])));
+    }
+    if (isPlainObject(left) && isPlainObject(right)) {
+        const leftKeys = Object.keys(left);
+        const rightKeys = Object.keys(right);
+        return (leftKeys.length === rightKeys.length &&
+            leftKeys.every((key) => Object.prototype.hasOwnProperty.call(right, key) && jsonEqual(left[key], right[key])));
+    }
+    return false;
+}
+/**
+ * Coerce an {@link ActionSchema} into a plain JSON Schema object suitable for
+ * sending to the relay as an action descriptor's `input_schema`/`output_schema`.
+ *
+ * - A JSON-schema-lite object (the relay's native shape) is returned as-is.
+ * - A standard-schema validator (e.g. `zod`) is converted via its JSON Schema
+ *   bridge when one is available, falling back to a permissive object schema.
+ * - `undefined` yields `undefined` (the descriptor omits the schema).
+ */
+export function actionSchemaToJsonSchema(schema) {
+    if (schema === undefined) {
+        return undefined;
+    }
+    if (isValidatorSchema(schema)) {
+        return validatorToJsonSchema(schema);
+    }
+    // A JSON-schema-lite definition: pass the object form through. Boolean
+    // schemas (`true`/`false`) have no object representation the relay accepts,
+    // so omit them.
+    if (typeof schema === 'object' && !Array.isArray(schema)) {
+        return schema;
+    }
+    return undefined;
+}
+function isValidatorSchema(schema) {
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        !Array.isArray(schema) &&
+        typeof schema.safeParse === 'function');
+}
+/**
+ * Best-effort conversion of a validator (zod and the like) into JSON Schema.
+ * Supports a per-instance `toJSONSchema()`/`toJsonSchema()` method or a zod-v4
+ * style schema convertible via `z.toJSONSchema`. Anything else degrades to a
+ * permissive object schema so descriptor registration never throws.
+ */
+function validatorToJsonSchema(schema) {
+    const candidate = schema;
+    for (const method of ['toJSONSchema', 'toJsonSchema']) {
+        const fn = candidate[method];
+        if (typeof fn === 'function') {
+            try {
+                const result = fn.call(schema);
+                if (isPlainObject(result)) {
+                    return result;
+                }
+            }
+            catch {
+                // fall through to other strategies
+            }
+        }
+    }
+    const zodSchema = tryZodToJsonSchema(schema);
+    if (zodSchema) {
+        return zodSchema;
+    }
+    // Could not convert the validator: the relay descriptor advertises a
+    // permissive schema, but local validation still enforces the real one.
+    console.warn('[agent-relay] could not convert an action input schema to JSON Schema; ' +
+        'the relay descriptor will advertise a permissive schema (local validation is unaffected).');
+    return { type: 'object', additionalProperties: true };
+}
+function tryZodToJsonSchema(schema) {
+    // The marker `_zod`/`_def` distinguishes a real zod schema from an arbitrary
+    // `safeParse` object, so conversion is only attempted on zod instances.
+    const looksLikeZod = '_zod' in schema || '_def' in schema;
+    if (!looksLikeZod) {
+        return undefined;
+    }
+    try {
+        // Resolved lazily to avoid a hard zod dependency (and a static node:module
+        // import) in the SDK.
+        const createRequire = nodeCreateRequire();
+        if (!createRequire) {
+            return undefined;
+        }
+        const req = createRequire(import.meta.url);
+        for (const entry of ['zod/v4', 'zod']) {
+            try {
+                const mod = req(entry);
+                if (typeof mod.toJSONSchema === 'function') {
+                    const result = mod.toJSONSchema(schema);
+                    if (isPlainObject(result)) {
+                        return result;
+                    }
+                }
+            }
+            catch {
+                // try the next entry point
+            }
+        }
+    }
+    catch {
+        // require unavailable (unexpected in Node); degrade gracefully
+    }
+    return undefined;
+}
+//# sourceMappingURL=json-schema-lite.js.map

package/dist/actions/json-schema-lite.js.map

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

package/dist/actions/registry.d.ts

@@ -0,0 +1,20 @@
+import type { ActionDefinition, ActionHandle, ActionListenerEvent, ActionResult, AgentRelayActionDescriptor, AgentRelayActions, ActionContext, InvokeActionInput } from './types.js';
+export declare class InMemoryAgentRelayActions implements AgentRelayActions {
+    private readonly actions;
+    private readonly eventHandlers;
+    onEvent(handler: (event: ActionListenerEvent) => void): () => void;
+    private emitListenerEvent;
+    register<TInput, TOutput>(definition: ActionDefinition<TInput, TOutput>): ActionHandle;
+    invoke<TOutput = unknown>(input: InvokeActionInput): Promise<ActionResult<TOutput>>;
+    list(input?: {
+        visibility?: 'agent' | 'human' | 'internal';
+    }): Promise<AgentRelayActionDescriptor[]>;
+    get(name: string): AgentRelayActionDescriptor | undefined;
+    has(name: string): boolean;
+    unregister(name: string): boolean;
+    clear(): void;
+    execute<TOutput = unknown>(name: string, input: unknown, context?: ActionContext): Promise<TOutput>;
+}
+export declare class ActionRegistry extends InMemoryAgentRelayActions {
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/actions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/actions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,0BAA0B,EAC1B,iBAAiB,EACjB,aAAa,EAKb,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAIpB,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmD;IAEjF,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,OAAO,CAAC,iBAAiB;IAUzB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAyBhF,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAmHnF,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAY1G,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAezD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,KAAK,IAAI,IAAI;IAIP,OAAO,CAAC,OAAO,GAAG,OAAO,EAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,aAA2C,GACnD,OAAO,CAAC,OAAO,CAAC;CAmBpB;AAED,qBAAa,cAAe,SAAQ,yBAAyB;CAAG"}

package/dist/actions/registry.js

@@ -0,0 +1,267 @@
+import { ActionNotFoundError, ActionRegistrationError, ActionValidationError } from './errors.js';
+import { validateJsonSchemaLite } from './json-schema-lite.js';
+export class InMemoryAgentRelayActions {
+    actions = new Map();
+    eventHandlers = new Set();
+    onEvent(handler) {
+        this.eventHandlers.add(handler);
+        return () => {
+            this.eventHandlers.delete(handler);
+        };
+    }
+    emitListenerEvent(event) {
+        for (const handler of this.eventHandlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // Listener errors must not break action invocation.
+            }
+        }
+    }
+    register(definition) {
+        const name = normalizeActionName(definition.name);
+        if (!name) {
+            throw new ActionRegistrationError('Action name is required');
+        }
+        if (this.actions.has(name)) {
+            throw new ActionRegistrationError(`Action already registered: ${name}`);
+        }
+        this.actions.set(name, {
+            ...definition,
+            name,
+            description: definition.description ?? name,
+            inputSchema: definition.inputSchema ?? definition.input,
+            outputSchema: definition.outputSchema ?? definition.output,
+            visibility: definition.visibility ?? 'agent',
+        });
+        return {
+            unregister: () => {
+                this.actions.delete(name);
+            },
+        };
+    }
+    async invoke(input) {
+        const name = normalizeActionName(input.name);
+        const definition = this.actions.get(name);
+        const context = actionContext(input);
+        if (!definition) {
+            return {
+                action: name,
+                ok: false,
+                error: { code: 'action_not_found', message: `Unknown action: ${name}` },
+            };
+        }
+        const at = new Date().toISOString();
+        await context.emit?.({
+            type: 'action.invoked',
+            action: name,
+            caller: context.caller.name,
+            at,
+        });
+        this.emitListenerEvent({
+            type: 'action.invoked',
+            action: name,
+            caller: context.caller,
+            input: input.input,
+            at,
+        });
+        const inputValidation = validateActionSchema(input.input, definition.inputSchema);
+        if (!inputValidation.valid) {
+            const message = formatValidationIssues(inputValidation.issues);
+            await context.emit?.({
+                type: 'action.failed',
+                action: name,
+                caller: context.caller.name,
+                at: new Date().toISOString(),
+                error: message,
+            });
+            return { action: name, ok: false, error: { code: 'invalid_input', message } };
+        }
+        const actionInput = inputValidation.value;
+        const decision = await definition.policy?.(actionInput, context);
+        if (decision && !decision.allowed) {
+            await context.emit?.({
+                type: 'action.denied',
+                action: name,
+                caller: context.caller.name,
+                at: new Date().toISOString(),
+                reason: decision.reason,
+            });
+            this.emitListenerEvent({
+                type: 'action.denied',
+                action: name,
+                caller: context.caller,
+                input: actionInput,
+                reason: decision.reason,
+                at: new Date().toISOString(),
+            });
+            return {
+                action: name,
+                ok: false,
+                error: { code: 'action_denied', message: decision.reason ?? 'Action denied' },
+            };
+        }
+        try {
+            const output = await definition.handler(actionInput, context);
+            const outputValidation = validateActionSchema(output, definition.outputSchema);
+            if (!outputValidation.valid) {
+                const message = formatValidationIssues(outputValidation.issues);
+                await context.emit?.({
+                    type: 'action.failed',
+                    action: name,
+                    caller: context.caller.name,
+                    at: new Date().toISOString(),
+                    error: message,
+                });
+                return { action: name, ok: false, error: { code: 'invalid_output', message } };
+            }
+            await context.emit?.({
+                type: 'action.completed',
+                action: name,
+                caller: context.caller.name,
+                at: new Date().toISOString(),
+            });
+            this.emitListenerEvent({
+                type: 'action.completed',
+                action: name,
+                caller: context.caller,
+                input: actionInput,
+                output: outputValidation.value,
+                at: new Date().toISOString(),
+            });
+            return { action: name, ok: true, output: outputValidation.value };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await context.emit?.({
+                type: 'action.failed',
+                action: name,
+                caller: context.caller.name,
+                at: new Date().toISOString(),
+                error: message,
+            });
+            this.emitListenerEvent({
+                type: 'action.failed',
+                action: name,
+                caller: context.caller,
+                input: actionInput,
+                error: message,
+                at: new Date().toISOString(),
+            });
+            return { action: name, ok: false, error: { code: 'action_failed', message } };
+        }
+    }
+    async list(input) {
+        return [...this.actions.values()]
+            .filter((definition) => !input?.visibility || (definition.visibility ?? 'agent') === input.visibility)
+            .map((definition) => ({
+            name: definition.name,
+            description: definition.description ?? definition.name,
+            inputSchema: definition.inputSchema,
+            outputSchema: definition.outputSchema,
+            visibility: definition.visibility ?? 'agent',
+        }));
+    }
+    get(name) {
+        const definition = this.actions.get(normalizeActionName(name));
+        if (!definition) {
+            return undefined;
+        }
+        return {
+            name: definition.name,
+            description: definition.description ?? definition.name,
+            inputSchema: definition.inputSchema,
+            outputSchema: definition.outputSchema,
+            visibility: definition.visibility ?? 'agent',
+        };
+    }
+    has(name) {
+        return this.actions.has(normalizeActionName(name));
+    }
+    unregister(name) {
+        return this.actions.delete(normalizeActionName(name));
+    }
+    clear() {
+        this.actions.clear();
+    }
+    async execute(name, input, context = { caller: { name: 'sdk' } }) {
+        const result = await this.invoke({ name, input, context });
+        if (result.ok) {
+            return result.output;
+        }
+        const actionName = normalizeActionName(name);
+        if (result.error?.code === 'action_not_found') {
+            throw new ActionNotFoundError(actionName);
+        }
+        if (result.error?.code === 'invalid_input') {
+            throw new ActionValidationError(actionName, 'input', [{ path: '$', message: result.error.message }]);
+        }
+        if (result.error?.code === 'invalid_output') {
+            throw new ActionValidationError(actionName, 'output', [{ path: '$', message: result.error.message }]);
+        }
+        throw new Error(result.error?.message ?? `Action failed: ${actionName}`);
+    }
+}
+export class ActionRegistry extends InMemoryAgentRelayActions {
+}
+function normalizeActionName(name) {
+    return name.trim();
+}
+function formatValidationIssues(issues) {
+    return issues.map((issue) => `${issue.path}: ${issue.message}`).join('; ');
+}
+function validateActionSchema(input, schema) {
+    if (isZodLikeSchema(schema)) {
+        const result = schema.safeParse(input);
+        if (result.success) {
+            return { valid: true, issues: [], value: result.data };
+        }
+        return {
+            valid: false,
+            issues: zodIssues(result.error),
+            value: input,
+        };
+    }
+    // Anything with a `safeParse` method was handled above, so the remainder is
+    // a JSON-schema-lite definition.
+    return {
+        ...validateJsonSchemaLite(input, schema),
+        value: input,
+    };
+}
+function isZodLikeSchema(schema) {
+    return Boolean(schema &&
+        typeof schema === 'object' &&
+        !Array.isArray(schema) &&
+        typeof schema.safeParse === 'function');
+}
+function zodIssues(error) {
+    const issues = error.issues ?? [];
+    if (issues.length === 0) {
+        return [{ path: '$', message: 'invalid value' }];
+    }
+    return issues.map((issue) => ({
+        path: formatZodPath(issue.path ?? []),
+        message: issue.message,
+    }));
+}
+function formatZodPath(path) {
+    if (path.length === 0)
+        return '$';
+    let result = '$';
+    for (const part of path) {
+        result = typeof part === 'number' ? `${result}[${part}]` : `${result}.${part}`;
+    }
+    return result;
+}
+function actionContext(input) {
+    return {
+        ...input.context,
+        caller: input.context?.caller ?? input.caller ?? { name: 'sdk' },
+        workspaceId: input.context?.workspaceId ?? input.workspaceId,
+        messaging: input.context?.messaging ?? input.messaging,
+        emit: input.context?.emit ?? input.emit,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/actions/registry.js.map

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