@frontmcp/sdk 0.11.3 → 0.12.0

package/README.md

@@ -7,7 +7,7 @@ The core FrontMCP framework for building MCP servers and clients in TypeScript.
 ## Install
 
 ```bash
-npm install @frontmcp/sdk reflect-metadata
+npm install @frontmcp/sdk
 ```
 
 > Most users should scaffold with `npx frontmcp create my-app` instead of installing manually. See [Installation][docs-install].

package/common/decorators/index.d.ts

@@ -12,4 +12,6 @@ export * from './prompt.decorator';
 export * from './logger.decorator';
 export * from './agent.decorator';
 export * from './skill.decorator';
+export * from './job.decorator';
+export * from './workflow.decorator';
 //# sourceMappingURL=index.d.ts.map

package/common/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/common/decorators/job.decorator.d.ts

@@ -0,0 +1,20 @@
+import 'reflect-metadata';
+import { JobMetadata } from '../metadata/job.metadata';
+import { ToolInputType, ToolOutputType } from '../metadata';
+import { JobContext } from '../interfaces';
+import { ToolInputOf, ToolOutputOf } from './tool.decorator';
+/**
+ * Decorator that marks a class as a Job and provides metadata.
+ */
+declare function FrontMcpJob(providedMetadata: JobMetadata): ClassDecorator;
+export type FrontMcpJobExecuteHandler<InSchema extends ToolInputType, OutSchema extends ToolOutputType, In = ToolInputOf<{
+    inputSchema: InSchema;
+}>, Out = ToolOutputOf<{
+    outputSchema: OutSchema;
+}>> = (input: In, ctx: JobContext<InSchema, OutSchema>) => Out | Promise<Out>;
+/**
+ * Function builder for creating jobs without classes.
+ */
+declare function frontMcpJob<T extends JobMetadata, InSchema extends ToolInputType = T['inputSchema'], OutSchema extends ToolOutputType = NonNullable<T['outputSchema']>>(providedMetadata: T): (handler: FrontMcpJobExecuteHandler<InSchema, OutSchema>) => () => FrontMcpJobExecuteHandler<InSchema, OutSchema>;
+export { FrontMcpJob, FrontMcpJob as Job, frontMcpJob, frontMcpJob as job };
+//# sourceMappingURL=job.decorator.d.ts.map

package/common/decorators/job.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/job.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAA6B,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;GAEG;AACH,iBAAS,WAAW,CAAC,gBAAgB,EAAE,WAAW,GAAG,cAAc,CAclE;AAED,MAAM,MAAM,yBAAyB,CACnC,QAAQ,SAAS,aAAa,EAC9B,SAAS,SAAS,cAAc,EAChC,EAAE,GAAG,WAAW,CAAC;IAAE,WAAW,EAAE,QAAQ,CAAA;CAAE,CAAC,EAC3C,GAAG,GAAG,YAAY,CAAC;IAAE,YAAY,EAAE,SAAS,CAAA;CAAE,CAAC,IAC7C,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAE5E;;GAEG;AACH,iBAAS,WAAW,CAClB,CAAC,SAAS,WAAW,EACrB,QAAQ,SAAS,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,EACjD,SAAS,SAAS,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAEjE,gBAAgB,EAAE,CAAC,GAClB,CAAC,OAAO,EAAE,yBAAyB,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,MAAM,yBAAyB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAYnH;AAED,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,GAAG,EAAE,WAAW,EAAE,WAAW,IAAI,GAAG,EAAE,CAAC"}

package/common/decorators/workflow.decorator.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+import { WorkflowMetadata } from '../metadata/workflow.metadata';
+/**
+ * Decorator that marks a class as a Workflow and provides metadata.
+ */
+declare function FrontMcpWorkflow(providedMetadata: WorkflowMetadata): ClassDecorator;
+/**
+ * Function builder for creating workflows declaratively.
+ */
+declare function frontMcpWorkflow(providedMetadata: WorkflowMetadata): () => void;
+export { FrontMcpWorkflow, FrontMcpWorkflow as Workflow, frontMcpWorkflow, frontMcpWorkflow as workflow };
+//# sourceMappingURL=workflow.decorator.d.ts.map

package/common/decorators/workflow.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAkC,MAAM,+BAA+B,CAAC;AAEjG;;GAEG;AACH,iBAAS,gBAAgB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CAc5E;AAED;;GAEG;AACH,iBAAS,gBAAgB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAUxE;AAED,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,IAAI,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,IAAI,QAAQ,EAAE,CAAC"}

package/common/entries/index.d.ts

@@ -13,4 +13,6 @@ export * from './prompt.entry';
 export * from './logger.entry';
 export * from './agent.entry';
 export * from './skill.entry';
+export * from './job.entry';
+export * from './workflow.entry';
 //# sourceMappingURL=index.d.ts.map

package/common/entries/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/entries/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/entries/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/common/entries/job.entry.d.ts

@@ -0,0 +1,40 @@
+import { BaseEntry, EntryOwnerRef } from './base.entry';
+import { JobRecord } from '../records';
+import { JobContext } from '../interfaces';
+import { ToolInputType, ToolOutputType } from '../metadata';
+import { JobMetadata } from '../metadata/job.metadata';
+import { ToolInputOf, ToolOutputOf } from '../decorators';
+import type ProviderRegistry from '../../provider/provider.registry';
+import type { SafeTransformResult } from './tool.entry';
+export declare abstract class JobEntry<InSchema extends ToolInputType = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType, In = ToolInputOf<{
+    inputSchema: InSchema;
+}>, Out = ToolOutputOf<{
+    outputSchema: OutSchema;
+}>> extends BaseEntry<JobRecord, JobContext<InSchema, OutSchema, In, Out>, JobMetadata> {
+    owner: EntryOwnerRef;
+    name: string;
+    fullName: string;
+    inputSchema: InSchema;
+    outputSchema: OutSchema;
+    abstract get providers(): ProviderRegistry;
+    isDynamic(): boolean;
+    isHidden(): boolean;
+    getTags(): string[];
+    getLabels(): Record<string, string>;
+    /**
+     * Get the job's input schema as JSON Schema.
+     */
+    getInputJsonSchema(): Record<string, unknown> | null;
+    /**
+     * Get the job's output schema as JSON Schema.
+     */
+    getOutputJsonSchema(): Record<string, unknown> | null;
+    abstract create(input: In, extra: {
+        authInfo: Partial<Record<string, unknown>>;
+        contextProviders?: unknown;
+    }): JobContext<InSchema, OutSchema, In, Out>;
+    abstract parseInput(input: unknown): In;
+    abstract parseOutput(raw: Out | Partial<Out>): unknown;
+    abstract safeParseOutput(raw: Out | Partial<Out>): SafeTransformResult<unknown>;
+}
+//# sourceMappingURL=job.entry.d.ts.map

package/common/entries/job.entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/job.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,SAAS,EAAW,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,gBAAgB,MAAM,kCAAkC,CAAC;AAGrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,8BAAsB,QAAQ,CAC5B,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC9C,SAAS,SAAS,cAAc,GAAG,cAAc,EACjD,EAAE,GAAG,WAAW,CAAC;IAAE,WAAW,EAAE,QAAQ,CAAA;CAAE,CAAC,EAC3C,GAAG,GAAG,YAAY,CAAC;IAAE,YAAY,EAAE,SAAS,CAAA;CAAE,CAAC,CAC/C,SAAQ,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,WAAW,CAAC;IACnF,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,WAAW,EAAE,QAAQ,CAAC;IACtB,YAAY,EAAE,SAAS,CAAC;IAExB,QAAQ,KAAK,SAAS,IAAI,gBAAgB,CAAC;IAE3C,SAAS,IAAI,OAAO;IAIpB,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,MAAM,EAAE;IAInB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWpD;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgBrD,QAAQ,CAAC,MAAM,CACb,KAAK,EAAE,EAAE,EACT,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAChF,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC;IAE3C,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE;IAEvC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;IAEtD,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC;CAChF"}

package/common/entries/workflow.entry.d.ts

@@ -0,0 +1,15 @@
+import { BaseEntry, EntryOwnerRef } from './base.entry';
+import { WorkflowRecord } from '../records';
+import { WorkflowMetadata, WorkflowStep } from '../metadata/workflow.metadata';
+export declare abstract class WorkflowEntry extends BaseEntry<WorkflowRecord, unknown, WorkflowMetadata> {
+    owner: EntryOwnerRef;
+    name: string;
+    fullName: string;
+    isDynamic(): boolean;
+    isHidden(): boolean;
+    getTags(): string[];
+    getLabels(): Record<string, string>;
+    getSteps(): WorkflowStep[];
+    getTrigger(): string;
+}
+//# sourceMappingURL=workflow.entry.d.ts.map

package/common/entries/workflow.entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/workflow.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE/E,8BAAsB,aAAc,SAAQ,SAAS,CAAC,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC;IAC9F,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,SAAS,IAAI,OAAO;IAIpB,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,MAAM,EAAE;IAInB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,QAAQ,IAAI,YAAY,EAAE;IAI1B,UAAU,IAAI,MAAM;CAGrB"}

package/common/interfaces/index.d.ts

@@ -18,5 +18,7 @@ export * from './logger.interface';
 export * from './llm-adapter.interface';
 export * from './agent.interface';
 export * from './skill.interface';
+export * from './job.interface';
+export * from './workflow.interface';
 export * from './internal';
 //# sourceMappingURL=index.d.ts.map

package/common/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,cAAc,YAAY,CAAC"}

package/common/interfaces/internal/registry.interface.d.ts

@@ -109,9 +109,11 @@ export interface AgentRegistryInterface {
 }
 export type GlobalRegistryKind = 'LoggerRegistry' | 'ScopeRegistry';
 export type ScopedRegistryKind = 'AppRegistry' | 'AuthRegistry' | 'FlowRegistry' | 'HookRegistry';
-export type AppRegistryKind = 'ProviderRegistry' | 'PluginRegistry' | 'AdapterRegistry' | 'ToolRegistry' | 'PromptRegistry' | 'ResourceRegistry' | 'AgentRegistry' | 'SkillRegistry';
+export type AppRegistryKind = 'ProviderRegistry' | 'PluginRegistry' | 'AdapterRegistry' | 'ToolRegistry' | 'PromptRegistry' | 'ResourceRegistry' | 'AgentRegistry' | 'SkillRegistry' | 'JobRegistry' | 'WorkflowRegistry';
 export type RegistryKind = GlobalRegistryKind | ScopedRegistryKind | AppRegistryKind;
 import type { SkillRegistryInterface } from '../../../skill/skill.registry';
+import type { JobRegistryInterface } from '../../../job/job.registry';
+import type { WorkflowRegistryInterface } from '../../../workflow/workflow.registry';
 export type RegistryType = {
     LoggerRegistry: LoggerRegistryInterface;
     ScopeRegistry: ScopeRegistryInterface;
@@ -127,5 +129,7 @@ export type RegistryType = {
     PromptRegistry: PromptRegistryInterface;
     AgentRegistry: AgentRegistryInterface;
     SkillRegistry: SkillRegistryInterface;
+    JobRegistry: JobRegistryInterface;
+    WorkflowRegistry: WorkflowRegistryInterface;
 };
 //# sourceMappingURL=registry.interface.d.ts.map

package/common/interfaces/internal/registry.interface.d.ts.map

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

package/common/interfaces/job.interface.d.ts

@@ -0,0 +1,40 @@
+import { FuncType, Type } from '@frontmcp/di';
+import { ToolInputType, ToolOutputType } from '../metadata';
+import { JobMetadata } from '../metadata/job.metadata';
+import { ToolInputOf, ToolOutputOf } from '../decorators';
+import { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';
+export type JobType<T = unknown> = Type<T> | FuncType<T>;
+export type JobCtorArgs<In> = ExecutionContextBaseArgs & {
+    metadata: JobMetadata;
+    input: In;
+    attempt: number;
+};
+export declare abstract class JobContext<InSchema extends ToolInputType = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType, In = ToolInputOf<{
+    inputSchema: InSchema;
+}>, Out = ToolOutputOf<{
+    outputSchema: OutSchema;
+}>> extends ExecutionContextBase<Out> {
+    protected readonly jobId: string;
+    protected readonly jobName: string;
+    readonly metadata: JobMetadata;
+    private _input;
+    private _output?;
+    private readonly _attempt;
+    private readonly _logs;
+    constructor(args: JobCtorArgs<In>);
+    abstract execute(input: In): Promise<Out>;
+    get input(): In;
+    get output(): Out | undefined;
+    set output(v: Out | undefined);
+    /** Current retry attempt number (1-based). */
+    get attempt(): number;
+    /** Log a message within the job execution. */
+    protected log(message: string): void;
+    /** Report progress. Returns false if no session is available. */
+    protected progress(pct: number, total?: number, msg?: string): Promise<boolean>;
+    /** Immediately respond with a value and stop execution. */
+    respond(value: Out): never;
+    /** Get all logs recorded during execution. */
+    getLogs(): readonly string[];
+}
+//# sourceMappingURL=job.interface.d.ts.map

package/common/interfaces/job.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/job.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEzD,MAAM,MAAM,WAAW,CAAC,EAAE,IAAI,wBAAwB,GAAG;IACvD,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,EAAE,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,8BAAsB,UAAU,CAC9B,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC9C,SAAS,SAAS,cAAc,GAAG,cAAc,EACjD,EAAE,GAAG,WAAW,CAAC;IAAE,WAAW,EAAE,QAAQ,CAAA;CAAE,CAAC,EAC3C,GAAG,GAAG,YAAY,CAAC;IAAE,YAAY,EAAE,SAAS,CAAA;CAAE,CAAC,CAC/C,SAAQ,oBAAoB,CAAC,GAAG,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAE1B,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;IAcjC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAEzC,IAAI,KAAK,IAAI,EAAE,CAEd;IAED,IAAI,MAAM,IAAI,GAAG,GAAG,SAAS,CAE5B;IAED,IAAI,MAAM,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,EAE5B;IAED,8CAA8C;IAC9C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,8CAA8C;IAC9C,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKpC,iEAAiE;cACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASrF,2DAA2D;IAC3D,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAK1B,8CAA8C;IAC9C,OAAO,IAAI,SAAS,MAAM,EAAE;CAG7B"}

package/common/interfaces/workflow.interface.d.ts

@@ -0,0 +1,27 @@
+import { FuncType, Type } from '@frontmcp/di';
+import { WorkflowMetadata, WorkflowStepResult } from '../metadata/workflow.metadata';
+import { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';
+export type WorkflowType<T = unknown> = Type<T> | FuncType<T>;
+export interface WorkflowExecutionResult {
+    workflowName: string;
+    state: 'completed' | 'failed';
+    stepResults: Record<string, WorkflowStepResult>;
+    startedAt: number;
+    completedAt: number;
+}
+export type WorkflowCtorArgs = ExecutionContextBaseArgs & {
+    metadata: WorkflowMetadata;
+};
+/**
+ * WorkflowContext wraps the engine execution.
+ * Unlike JobContext, this is NOT user-subclassed.
+ */
+export declare class WorkflowContext extends ExecutionContextBase<WorkflowExecutionResult> {
+    readonly metadata: WorkflowMetadata;
+    private _stepResults;
+    constructor(args: WorkflowCtorArgs);
+    get workflowName(): string;
+    get workflowId(): string;
+    get stepResults(): ReadonlyMap<string, WorkflowStepResult>;
+}
+//# sourceMappingURL=workflow.interface.d.ts.map

package/common/interfaces/workflow.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/workflow.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,GAAG;IACxD,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,oBAAoB,CAAC,uBAAuB,CAAC;IAChF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,YAAY,CAAyC;gBAEjD,IAAI,EAAE,gBAAgB;IAUlC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAEzD;CAMF"}

package/common/metadata/app.metadata.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { AuthOptionsInput } from '../types';
-import { AgentType, ProviderType, PromptType, ResourceType, ToolType, AuthProviderType, PluginType, AdapterType, SkillType } from '../interfaces';
+import { AgentType, ProviderType, PromptType, ResourceType, ToolType, AuthProviderType, PluginType, AdapterType, SkillType, JobType, WorkflowType } from '../interfaces';
 /**
  * Declarative metadata describing what a local mcp app contributes at app scope.
  *
@@ -78,6 +78,16 @@ export interface LocalAppMetadata {
      * recipes. They can be discovered via searchSkills and loaded via loadSkill.
      */
     skills?: SkillType[];
+    /**
+     * Jobs registered by this app.
+     * Jobs are pure executable units with strict input/output schemas.
+     */
+    jobs?: JobType[];
+    /**
+     * Workflows registered by this app.
+     * Workflows connect jobs into managed steps with triggers.
+     */
+    workflows?: WorkflowType[];
     /**
      * Configures the app's default authentication provider.
      * If not provided, the app will use the gateway's default auth provider.
@@ -104,6 +114,8 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
     prompts: z.ZodOptional<z.ZodArray<z.ZodCustom<import("libs/di/dist/interfaces/base.interface").Type<unknown>, import("libs/di/dist/interfaces/base.interface").Type<unknown>>>>;
     agents: z.ZodOptional<z.ZodArray<z.ZodCustom<AgentType, AgentType>>>;
     skills: z.ZodOptional<z.ZodArray<z.ZodCustom<import("libs/di/dist/interfaces/base.interface").Type<unknown>, import("libs/di/dist/interfaces/base.interface").Type<unknown>>>>;
+    jobs: z.ZodOptional<z.ZodArray<z.ZodCustom<import("libs/di/dist/interfaces/base.interface").Type<unknown>, import("libs/di/dist/interfaces/base.interface").Type<unknown>>>>;
+    workflows: z.ZodOptional<z.ZodArray<z.ZodCustom<import("libs/di/dist/interfaces/base.interface").Type<unknown>, import("libs/di/dist/interfaces/base.interface").Type<unknown>>>>;
     auth: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         mode: z.ZodLiteral<"public">;
         issuer: z.ZodOptional<z.ZodString>;

package/common/metadata/app.metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.metadata.d.ts","sourceRoot":"","sources":["../../../src/common/metadata/app.metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAkC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACV,MAAM,eAAe,CAAC;AAavB;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAE3B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC1C;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBD,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB;IACE;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,uBAAuB,CAAC;CACtC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,OAAO,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAE1C;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C;;;OAGG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC;CACzC;AA+BD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBD,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"app.metadata.d.ts","sourceRoot":"","sources":["../../../src/common/metadata/app.metadata.ts"],"names":[],"mappings":"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"}