@sapiom/agent-core 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @sapiom/orchestration-core
 
+## 0.8.0
+
+### Minor Changes
+
+- 3dfbd10: Ship the `sapiom-agent-authoring` skill with every scaffold, and finish the MCP
+  instructions rename.
+
+  - New canonical skill (`agent-core/skills/sapiom-agent-authoring/SKILL.md`) with a
+    task-shape trigger ("automate a multi-step / scheduled / deployable task"), the full
+    authoring guide (`defineAgent`, directives, pause/resume, stubs), and a bootstrap
+    step for agents whose client doesn't have the sapiom-dev MCP yet.
+  - Both scaffold templates ship it at `.claude/skills/sapiom-agent-authoring/` (auto-loads
+    as a project skill in Claude Code) and `AGENTS.md` points to it, so every scaffolded
+    project self-documents. A sync test keeps template copies identical to the canonical.
+  - `@sapiom/mcp`'s bundled instructions fallback rewritten to the agents/models
+    vocabulary (the rename left it on the old text), thinned to lifecycle + canonical
+    rules + pointers — deep guidance lives in the skill/AGENTS.md/docs.
+
+### Patch Changes
+
+- 020139a: `check()` now recognizes workflow definitions authored against the pre-rename SDK: `@sapiom/agent` exports `isLegacyOrchestrationDefinition`/`LEGACY_ORCHESTRATION_DEFINITION_BRAND` (the `Symbol.for('sapiom.orchestration.definition')` brand the old `defineOrchestration` attached), and `@sapiom/agent-core`'s `check()` accepts either brand in its export detection — the definition shape is unchanged by the rename, so manifests build identically. `check()` also gains a `typecheck` option (default `true`): pass `typecheck: false` to skip the project's `tsc --noEmit` when only the manifest/graph is needed (esbuild still surfaces bundle-level breakage).
+- Updated dependencies [020139a]
+  - @sapiom/agent@0.6.1
+
+## 0.7.0
+
+### Minor Changes
+
+- 7a9d57a: Rename the execution-context field `ctx.workflowName` → `ctx.agentName`.
+
+  **Breaking:** a step that reads `ctx.workflowName` must now read `ctx.agentName`. The value is unchanged — the agent's name (slug).
+
+### Patch Changes
+
+- Updated dependencies [7a9d57a]
+  - @sapiom/agent@0.6.0
+  - @sapiom/agent-runtime@0.3.1
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/cjs/check.d.ts

@@ -1,5 +1,6 @@
 export interface CheckOptions {
     sourceDir: string;
+    typecheck?: boolean;
 }
 export interface CheckResult {
     name: string;

package/dist/cjs/check.js

@@ -76,9 +76,11 @@ async function check(opts) {
         });
     }
     const warnings = [];
-    const typecheckSkip = runTypecheck(sourceDir);
-    if (typecheckSkip)
-        warnings.push(typecheckSkip);
+    if (opts.typecheck !== false) {
+        const typecheckSkip = runTypecheck(sourceDir);
+        if (typecheckSkip)
+            warnings.push(typecheckSkip);
+    }
     const tmp = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), 'sapiom-check-'));
     const bundlePath = node_path_1.default.join(tmp, 'definition.mjs');
     try {
@@ -103,8 +105,9 @@ async function check(opts) {
         const mod = await Promise.resolve(`${`file://${bundlePath}?t=${Date.now()}`}`).then(s => __importStar(require(s)));
         const defs = [];
         for (const value of Object.values(mod)) {
-            if ((0, agent_1.isAgentDefinition)(value) && !defs.includes(value))
+            if (((0, agent_1.isAgentDefinition)(value) || (0, agent_1.isLegacyOrchestrationDefinition)(value)) && !defs.includes(value)) {
                 defs.push(value);
+            }
         }
         if (defs.length === 0) {
             throw new errors_js_1.AgentOperationError({

package/dist/cjs/local/dispatcher.js

@@ -48,7 +48,7 @@ class LocalStubDispatcher {
         });
         const ctx = {
             executionId: request.executionId,
-            workflowName: request.workflowName,
+            agentName: request.workflowName,
             organizationId: request.organizationId,
             tenantId: request.tenantId,
             input: request.workflowInput,

package/dist/esm/check.d.ts

@@ -1,5 +1,6 @@
 export interface CheckOptions {
     sourceDir: string;
+    typecheck?: boolean;
 }
 export interface CheckResult {
     name: string;

package/dist/esm/check.js

@@ -3,7 +3,7 @@ import { createHash } from 'node:crypto';
 import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
-import { assertValidGraph, buildManifest, isAgentDefinition, agentManifestSchema } from '@sapiom/agent';
+import { assertValidGraph, buildManifest, isAgentDefinition, isLegacyOrchestrationDefinition, agentManifestSchema, } from '@sapiom/agent';
 import * as esbuild from 'esbuild';
 import { AgentOperationError } from './errors.js';
 function runTypecheck(sourceDir) {
@@ -37,9 +37,11 @@ export async function check(opts) {
         });
     }
     const warnings = [];
-    const typecheckSkip = runTypecheck(sourceDir);
-    if (typecheckSkip)
-        warnings.push(typecheckSkip);
+    if (opts.typecheck !== false) {
+        const typecheckSkip = runTypecheck(sourceDir);
+        if (typecheckSkip)
+            warnings.push(typecheckSkip);
+    }
     const tmp = mkdtempSync(path.join(tmpdir(), 'sapiom-check-'));
     const bundlePath = path.join(tmp, 'definition.mjs');
     try {
@@ -64,8 +66,9 @@ export async function check(opts) {
         const mod = await import(`file://${bundlePath}?t=${Date.now()}`);
         const defs = [];
         for (const value of Object.values(mod)) {
-            if (isAgentDefinition(value) && !defs.includes(value))
+            if ((isAgentDefinition(value) || isLegacyOrchestrationDefinition(value)) && !defs.includes(value)) {
                 defs.push(value);
+            }
         }
         if (defs.length === 0) {
             throw new AgentOperationError({

package/dist/esm/local/dispatcher.js

@@ -45,7 +45,7 @@ export class LocalStubDispatcher {
         });
         const ctx = {
             executionId: request.executionId,
-            workflowName: request.workflowName,
+            agentName: request.workflowName,
             organizationId: request.organizationId,
             tenantId: request.tenantId,
             input: request.workflowInput,