@jigging/agent-method 0.1.0-alpha.4 → 0.1.0-alpha.5

package/AGENTS.md

@@ -73,6 +73,8 @@ ordinary Flow, preserving operator ownership of Agent execution.
 - The ordinary ACP package imports this same method. `checkAgentResult` lets
   consumers independently check any selected
   Agent's dynamic structured result; it grants no authority or provenance.
+  Its validated `AgentResult` is assignable to portable FLOW JSON without a
+  cast; arbitrary exceptions and non-JSON values are not.
 
 ## Work Guidance
 

package/dist/index.d.ts

@@ -51,14 +51,14 @@ export interface PreparedAgent {
     readonly request: AgentTransportInput;
     readonly session?: AgentSessionRequest;
 }
-export interface AgentResult {
+export type AgentResult = {
     readonly outcome: 'done' | 'blocked' | 'limit';
     readonly output: {
         readonly text: string;
         readonly structured?: JsonValue;
         readonly session?: AgentSessionReceipt;
     };
-}
+};
 /** Independently check an Agent Flow result at its consumer's boundary. */
 export declare function checkAgentResult(value: unknown, responseSchema?: JsonObject): AgentResult;
 /** Prepare one bounded request. The returned data confers no execution authority. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jigging/agent-method",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "description": "A reusable bounded Agent method with an ordinary FLOW entrypoint",
   "license": "MPL-2.0",
   "repository": {
@@ -47,7 +47,7 @@
     "test"
   ],
   "devDependencies": {
-    "@jigging/flow": "0.1.0-alpha.12",
+    "@jigging/flow": "0.1.0-alpha.13",
     "@types/node": "24.13.3",
     "typescript": "7.0.2"
   }

package/src/index.ts

@@ -64,7 +64,7 @@ export interface PreparedAgent {
   readonly session?: AgentSessionRequest
 }
 
-export interface AgentResult {
+export type AgentResult = {
   readonly outcome: 'done' | 'blocked' | 'limit'
   readonly output: {
     readonly text: string

package/test/fixtures/public-result-types.ts

@@ -0,0 +1,17 @@
+import { type AgentResult, checkAgentResult } from '@jigging/agent-method'
+import type { JsonValue, RunHandler } from '@jigging/flow'
+
+const result: AgentResult = checkAgentResult({ outcome: 'done', output: { text: 'answer' } })
+const direct: JsonValue = result
+const nested: JsonValue = { agent: result }
+const handler: RunHandler = async () => ({ outcome: 'done', output: result })
+
+void [direct, nested, handler]
+
+// @ts-expect-error Functions are not JSON values.
+const functionOutput: JsonValue = () => 'answer'
+// @ts-expect-error Undefined is not a JSON value.
+const undefinedOutput: JsonValue = undefined
+// @ts-expect-error Error objects are not JSON values.
+const errorOutput: JsonValue = new Error('unhandled')
+void [functionOutput, undefinedOutput, errorOutput]

package/test/public-result-types.test.ts

@@ -0,0 +1,41 @@
+import { test } from 'bun:test'
+import { execFileSync } from 'node:child_process'
+import { copyFile, mkdir, mkdtemp, rm, symlink } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+test('public Agent results compose with FLOW JSON without casts', async () => {
+  const method = fileURLToPath(new URL('../', import.meta.url))
+  const flow = fileURLToPath(new URL('../../flow-sdk/', import.meta.url))
+  const consumer = await mkdtemp(join(tmpdir(), 'agent-public-types-'))
+  try {
+    await mkdir(join(consumer, 'node_modules/@jigging'), { recursive: true })
+    await symlink(method, join(consumer, 'node_modules/@jigging/agent-method'))
+    await symlink(flow, join(consumer, 'node_modules/@jigging/flow'))
+    await copyFile(
+      new URL('./fixtures/public-result-types.ts', import.meta.url),
+      join(consumer, 'consumer.ts'),
+    )
+    execFileSync(
+      process.execPath,
+      [
+        join(method, 'node_modules/typescript/bin/tsc'),
+        '--ignoreConfig',
+        '--noEmit',
+        '--strict',
+        '--exactOptionalPropertyTypes',
+        '--target',
+        'ES2022',
+        '--module',
+        'NodeNext',
+        '--moduleResolution',
+        'NodeNext',
+        'consumer.ts',
+      ],
+      { cwd: consumer, stdio: 'pipe' },
+    )
+  } finally {
+    await rm(consumer, { recursive: true, force: true })
+  }
+})