@frontmcp/sdk 0.1.0

package/src/entries/adapter.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class AdapterEntry extends base_entry_1.BaseEntry {
+}
+exports.AdapterEntry = AdapterEntry;
+//# sourceMappingURL=adapter.entry.js.map

package/src/entries/adapter.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.entry.js","sourceRoot":"","sources":["../../../src/entries/adapter.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,YAAa,SAAQ,sBAA2D;CAGrG;AAHD,oCAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { AdapterRecord } from '../records';\nimport { AdapterInterface } from '../interfaces';\nimport { AdapterMetadata } from '../metadata';\n\n\nexport abstract class AdapterEntry extends BaseEntry<AdapterRecord, AdapterInterface, AdapterMetadata> {\n\n\n}\n\n"]}

package/src/entries/app.entry.d.ts

@@ -0,0 +1,13 @@
+import { BaseEntry } from './base.entry';
+import { AppRecord } from '../records';
+import { AdapterRegistryInterface, AppInterface, PluginRegistryInterface, PromptRegistryInterface, ProviderRegistryInterface, ResourceRegistryInterface, ToolRegistryInterface } from '../interfaces';
+import { AppMetadata } from '../metadata';
+export declare abstract class AppEntry extends BaseEntry<AppRecord, AppInterface, AppMetadata> {
+    readonly id: string;
+    abstract get providers(): ProviderRegistryInterface;
+    abstract get adapters(): AdapterRegistryInterface;
+    abstract get plugins(): PluginRegistryInterface;
+    abstract get tools(): ToolRegistryInterface;
+    abstract get resources(): ResourceRegistryInterface;
+    abstract get prompts(): PromptRegistryInterface;
+}

package/src/entries/app.entry.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class AppEntry extends base_entry_1.BaseEntry {
+    id;
+}
+exports.AppEntry = AppEntry;
+//# sourceMappingURL=app.entry.js.map

package/src/entries/app.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.entry.js","sourceRoot":"","sources":["../../../src/entries/app.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AASzC,MAAsB,QAAS,SAAQ,sBAA+C;IAC3E,EAAE,CAAS;CAarB;AAdD,4BAcC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { AppRecord } from '../records';\nimport {\n  AdapterRegistryInterface,\n  AppInterface, PluginRegistryInterface, PromptRegistryInterface, ProviderRegistryInterface, ResourceRegistryInterface,\n  ToolRegistryInterface,\n} from '../interfaces';\nimport { AppMetadata } from '../metadata';\n\nexport abstract class AppEntry extends BaseEntry<AppRecord, AppInterface, AppMetadata> {\n  readonly id: string;\n\n  abstract get providers(): ProviderRegistryInterface;\n\n  abstract get adapters(): AdapterRegistryInterface;\n\n  abstract get plugins(): PluginRegistryInterface;\n\n  abstract get tools(): ToolRegistryInterface;\n\n  abstract get resources(): ResourceRegistryInterface;\n\n  abstract get prompts(): PromptRegistryInterface;\n}\n"]}

package/src/entries/auth-provider.entry.d.ts

@@ -0,0 +1,6 @@
+import { BaseEntry } from './base.entry';
+import { AuthProviderRecord } from '../records';
+import { AuthProviderInterface } from '../interfaces';
+import { AuthProviderMetadata } from '../metadata';
+export declare abstract class AuthProviderEntry extends BaseEntry<AuthProviderRecord, AuthProviderInterface, AuthProviderMetadata> {
+}

package/src/entries/auth-provider.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthProviderEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class AuthProviderEntry extends base_entry_1.BaseEntry {
+}
+exports.AuthProviderEntry = AuthProviderEntry;
+//# sourceMappingURL=auth-provider.entry.js.map

package/src/entries/auth-provider.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-provider.entry.js","sourceRoot":"","sources":["../../../src/entries/auth-provider.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,iBAAkB,SAAQ,sBAA0E;CAGzH;AAHD,8CAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { AuthProviderRecord } from '../records';\nimport { AuthProviderInterface } from '../interfaces';\nimport { AuthProviderMetadata } from '../metadata';\n\n\nexport abstract class AuthProviderEntry extends BaseEntry<AuthProviderRecord, AuthProviderInterface, AuthProviderMetadata> {\n\n\n}"]}

package/src/entries/base.entry.d.ts

@@ -0,0 +1,20 @@
+import 'reflect-metadata';
+import { Token } from '../interfaces';
+export type EntryOwnerKind = 'scope' | 'app' | 'plugin' | 'adapter';
+export type EntryOwnerRef = {
+    kind: EntryOwnerKind;
+    id: string;
+    ref: Token;
+};
+export type EntryLineage = EntryOwnerRef[];
+export declare abstract class BaseEntry<Record extends {
+    provide: any;
+    metadata: any;
+}, Interface, Metadata> {
+    ready: Promise<void>;
+    protected readonly record: Record;
+    protected readonly token: Token<Interface>;
+    readonly metadata: Metadata;
+    constructor(record: Record, token?: Token<Interface>, metadata?: Metadata);
+    protected abstract initialize(): Promise<void>;
+}

package/src/entries/base.entry.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseEntry = void 0;
+require("reflect-metadata");
+class BaseEntry {
+    ready;
+    record;
+    token;
+    metadata;
+    constructor(record, token, metadata) {
+        this.record = record;
+        this.token = token ?? record.provide;
+        this.metadata = metadata ?? record.metadata;
+    }
+}
+exports.BaseEntry = BaseEntry;
+//# sourceMappingURL=base.entry.js.map

package/src/entries/base.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.entry.js","sourceRoot":"","sources":["../../../src/entries/base.entry.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAQ1B,MAAsB,SAAS;IAC7B,KAAK,CAAgB;IACF,MAAM,CAAS;IACf,KAAK,CAAmB;IAClC,QAAQ,CAAW;IAE5B,YAAY,MAAc,EAAE,KAAwB,EAAE,QAAmB;QACvE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC9C,CAAC;CAGF;AAbD,8BAaC","sourcesContent":["import 'reflect-metadata';\nimport { Token } from '../interfaces';\n\nexport type EntryOwnerKind = 'scope' | 'app' | 'plugin' | 'adapter';\nexport type EntryOwnerRef = { kind: EntryOwnerKind; id: string, ref: Token };\nexport type EntryLineage = EntryOwnerRef[]; // root -> leaf; e.g. [{kind:'app', id:'Portal'}, {kind:'plugin', id:'Okta'}]\n\n\nexport abstract class BaseEntry<Record extends { provide: any, metadata: any }, Interface, Metadata> {\n  ready: Promise<void>;\n  protected readonly record: Record;\n  protected readonly token: Token<Interface>;\n  readonly metadata: Metadata;\n\n  constructor(record: Record, token?: Token<Interface>, metadata?: Metadata) {\n    this.record = record;\n    this.token = token ?? record.provide;\n    this.metadata = metadata ?? record.metadata;\n  }\n\n  protected abstract initialize(): Promise<void>;\n}\n"]}

package/src/entries/flow.entry.d.ts

@@ -0,0 +1,15 @@
+import 'reflect-metadata';
+import { BaseEntry } from './base.entry';
+import { FlowRecord } from '../records';
+import { FlowBase, FlowInputOf, FlowOutputOf, HttpMethod, ServerRequest, Token, Type } from '../interfaces';
+import { FlowMetadata, FlowName } from '../metadata';
+import { ScopeEntry } from './scope.entry';
+export declare abstract class FlowEntry<Name extends FlowName> extends BaseEntry<FlowRecord, FlowBase, FlowMetadata<never>> {
+    readonly name: Name;
+    readonly path?: RegExp | string;
+    readonly method?: HttpMethod;
+    readonly scope: ScopeEntry;
+    abstract canActivate(request: ServerRequest): Promise<boolean>;
+    abstract run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
+    protected constructor(scope: ScopeEntry, record: FlowRecord, token?: Token<FlowBase>, metadata?: FlowMetadata<never>);
+}

package/src/entries/flow.entry.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowEntry = void 0;
+require("reflect-metadata");
+const base_entry_1 = require("./base.entry");
+class FlowEntry extends base_entry_1.BaseEntry {
+    name;
+    path; // string can be "/test/**" or "/test/*/asds", default to all paths;
+    method;
+    scope;
+    constructor(scope, record, token, metadata) {
+        super(record, token, metadata);
+        const { path, method } = record.metadata.middleware ?? metadata?.middleware ?? {};
+        this.name = metadata?.name ?? record.metadata?.name;
+        this.path = path;
+        this.method = method;
+        this.scope = scope;
+    }
+}
+exports.FlowEntry = FlowEntry;
+//# sourceMappingURL=flow.entry.js.map

package/src/entries/flow.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.entry.js","sourceRoot":"","sources":["../../../src/entries/flow.entry.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAC1B,6CAAyC;AAQzC,MAAsB,SAAiC,SAAQ,sBAAoD;IACxG,IAAI,CAAO;IACX,IAAI,CAAmB,CAAC,oEAAoE;IAC5F,MAAM,CAAc;IACpB,KAAK,CAAa;IAM3B,YAAsB,KAAiB,EAAC,MAAkB,EAAE,KAAuB,EAAE,QAA8B;QACjH,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CAEF;AAnBD,8BAmBC","sourcesContent":["import 'reflect-metadata';\nimport { BaseEntry } from './base.entry';\nimport { FlowRecord } from '../records';\nimport { FlowBase, FlowInputOf, FlowOutputOf, HttpMethod, ServerRequest, Token, Type } from '../interfaces';\nimport { FlowMetadata, FlowName } from '../metadata';\nimport { ScopeEntry } from './scope.entry';\nimport { z } from 'zod';\n\n\nexport abstract class FlowEntry<Name extends FlowName> extends BaseEntry<FlowRecord, FlowBase, FlowMetadata<never>> {\n  readonly name: Name;\n  readonly path?: RegExp | string; // string can be \"/test/**\" or \"/test/*/asds\", default to all paths;\n  readonly method?: HttpMethod;\n  readonly scope: ScopeEntry;\n\n  abstract canActivate(request: ServerRequest): Promise<boolean>\n\n  abstract run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>\n\n  protected constructor(scope: ScopeEntry,record: FlowRecord, token?: Token<FlowBase>, metadata?: FlowMetadata<never>) {\n    super(record, token, metadata);\n    const { path, method } = record.metadata.middleware ?? metadata?.middleware ?? {};\n    this.name = metadata?.name ?? record.metadata?.name;\n    this.path = path;\n    this.method = method;\n    this.scope = scope;\n  }\n\n}\n\n"]}

package/src/entries/index.d.ts

@@ -0,0 +1,12 @@
+export * from './base.entry';
+export * from './scope.entry';
+export * from './flow.entry';
+export * from './app.entry';
+export * from './provider.entry';
+export * from './auth-provider.entry';
+export * from './plugin.entry';
+export * from './adapter.entry';
+export * from './tool.entry';
+export * from './resource.entry';
+export * from './prompt.entry';
+export * from './logger.entry';

package/src/entries/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./base.entry"), exports);
+tslib_1.__exportStar(require("./scope.entry"), exports);
+tslib_1.__exportStar(require("./flow.entry"), exports);
+tslib_1.__exportStar(require("./app.entry"), exports);
+tslib_1.__exportStar(require("./provider.entry"), exports);
+tslib_1.__exportStar(require("./auth-provider.entry"), exports);
+tslib_1.__exportStar(require("./plugin.entry"), exports);
+tslib_1.__exportStar(require("./adapter.entry"), exports);
+tslib_1.__exportStar(require("./tool.entry"), exports);
+tslib_1.__exportStar(require("./resource.entry"), exports);
+tslib_1.__exportStar(require("./prompt.entry"), exports);
+tslib_1.__exportStar(require("./logger.entry"), exports);
+//# sourceMappingURL=index.js.map

package/src/entries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entries/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,wDAA8B;AAC9B,uDAA6B;AAC7B,sDAA4B;AAC5B,2DAAiC;AACjC,gEAAsC;AACtC,yDAA+B;AAC/B,0DAAgC;AAChC,uDAA6B;AAC7B,2DAAiC;AACjC,yDAA+B;AAC/B,yDAA+B","sourcesContent":["export * from './base.entry';\nexport * from './scope.entry';\nexport * from './flow.entry';\nexport * from './app.entry';\nexport * from './provider.entry';\nexport * from './auth-provider.entry';\nexport * from './plugin.entry';\nexport * from './adapter.entry';\nexport * from './tool.entry';\nexport * from './resource.entry';\nexport * from './prompt.entry';\nexport * from './logger.entry';\n"]}

package/src/entries/logger.entry.d.ts

@@ -0,0 +1,6 @@
+import { BaseEntry } from './base.entry';
+import { LogTransportInterface } from '../interfaces';
+import { LoggerRecord } from '../records';
+import { LogTransportMetadata } from '../metadata';
+export declare abstract class LoggerEntry extends BaseEntry<LoggerRecord, LogTransportInterface, LogTransportMetadata> {
+}

package/src/entries/logger.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class LoggerEntry extends base_entry_1.BaseEntry {
+}
+exports.LoggerEntry = LoggerEntry;
+//# sourceMappingURL=logger.entry.js.map

package/src/entries/logger.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.entry.js","sourceRoot":"","sources":["../../../src/entries/logger.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,WAAY,SAAQ,sBAAoE;CAG7G;AAHD,kCAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { LogTransportInterface } from '../interfaces';\nimport { LoggerRecord } from '../records';\nimport { LogTransportMetadata } from '../metadata';\n\n\nexport abstract class LoggerEntry extends BaseEntry<LoggerRecord, LogTransportInterface, LogTransportMetadata> {\n\n\n}\n\n"]}

package/src/entries/plugin.entry.d.ts

@@ -0,0 +1,6 @@
+import { BaseEntry } from './base.entry';
+import { PluginRecord } from '../records';
+import { PluginInterface } from '../interfaces';
+import { PluginMetadata } from '../metadata';
+export declare abstract class PluginEntry extends BaseEntry<PluginRecord, PluginInterface, PluginMetadata> {
+}

package/src/entries/plugin.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class PluginEntry extends base_entry_1.BaseEntry {
+}
+exports.PluginEntry = PluginEntry;
+//# sourceMappingURL=plugin.entry.js.map

package/src/entries/plugin.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.entry.js","sourceRoot":"","sources":["../../../src/entries/plugin.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,WAAY,SAAQ,sBAAwD;CAGjG;AAHD,kCAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { PluginRecord } from '../records';\nimport { PluginInterface } from '../interfaces';\nimport { PluginMetadata } from '../metadata';\n\n\nexport abstract class PluginEntry extends BaseEntry<PluginRecord, PluginInterface, PluginMetadata> {\n\n\n}"]}

package/src/entries/prompt.entry.d.ts

@@ -0,0 +1,6 @@
+import { BaseEntry } from './base.entry';
+import { PromptRecord } from '../records';
+import { PromptInterface } from '../interfaces';
+import { PromptMetadata } from '../metadata';
+export declare abstract class PromptEntry extends BaseEntry<PromptRecord, PromptInterface, PromptMetadata> {
+}

package/src/entries/prompt.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class PromptEntry extends base_entry_1.BaseEntry {
+}
+exports.PromptEntry = PromptEntry;
+//# sourceMappingURL=prompt.entry.js.map

package/src/entries/prompt.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.entry.js","sourceRoot":"","sources":["../../../src/entries/prompt.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,WAAY,SAAQ,sBAAwD;CAGjG;AAHD,kCAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { PromptRecord } from '../records';\nimport { PromptInterface } from '../interfaces';\nimport { PromptMetadata } from '../metadata';\n\n\nexport abstract class PromptEntry extends BaseEntry<PromptRecord, PromptInterface, PromptMetadata> {\n\n\n}\n\n"]}

package/src/entries/provider.entry.d.ts

@@ -0,0 +1,7 @@
+import { BaseEntry } from './base.entry';
+import { ProviderRecord } from '../records';
+import { ProviderInterface } from '../interfaces';
+import { ProviderMetadata } from '../metadata';
+declare abstract class ProviderEntry extends BaseEntry<ProviderRecord, ProviderInterface, ProviderMetadata> {
+}
+export { ProviderEntry, };

package/src/entries/provider.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class ProviderEntry extends base_entry_1.BaseEntry {
+}
+exports.ProviderEntry = ProviderEntry;
+//# sourceMappingURL=provider.entry.js.map

package/src/entries/provider.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.entry.js","sourceRoot":"","sources":["../../../src/entries/provider.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAe,aAAc,SAAQ,sBAA8D;CAGlG;AAIC,sCAAa","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { ProviderRecord } from '../records';\nimport { ProviderInterface } from '../interfaces';\nimport { ProviderMetadata } from '../metadata';\n\n\nabstract class ProviderEntry extends BaseEntry<ProviderRecord, ProviderInterface, ProviderMetadata> {\n\n\n}\n\n\nexport {\n  ProviderEntry,\n};"]}

package/src/entries/resource.entry.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { BaseEntry } from './base.entry';
+import { ResourceRecord } from '../records';
+import { ResourceInterface } from '../interfaces';
+import { ResourceMetadata } from '../metadata';
+export declare abstract class ResourceEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ResourceRecord, ResourceInterface<In, Out>, ResourceMetadata> {
+}

package/src/entries/resource.entry.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class ResourceEntry extends base_entry_1.BaseEntry {
+}
+exports.ResourceEntry = ResourceEntry;
+// TODO: support resource templates
+// abstract class ResourceTemplateEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ResourceTemplateRecord, ResourceTemplateInterface<In, Out>, ResourceTemplateType> {
+// }
+//# sourceMappingURL=resource.entry.js.map

package/src/entries/resource.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.entry.js","sourceRoot":"","sources":["../../../src/entries/resource.entry.ts"],"names":[],"mappings":";;;AACA,6CAAyC;AAMzC,MAAsB,aAAuD,SAAQ,sBACtB;CAG9D;AAJD,sCAIC;AAGD,mCAAmC;AACnC,sLAAsL;AACtL,IAAI","sourcesContent":["import { z } from 'zod';\nimport { BaseEntry } from './base.entry';\nimport { ResourceRecord } from '../records';\nimport { ResourceInterface } from '../interfaces';\nimport { ResourceMetadata } from '../metadata';\n\n\nexport abstract class ResourceEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<\n  ResourceRecord, ResourceInterface<In, Out>, ResourceMetadata> {\n\n\n}\n\n\n// TODO: support resource templates\n// abstract class ResourceTemplateEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ResourceTemplateRecord, ResourceTemplateInterface<In, Out>, ResourceTemplateType> {\n// }"]}

package/src/entries/scope.entry.d.ts

@@ -0,0 +1,17 @@
+import { BaseEntry } from './base.entry';
+import { ScopeRecord } from '../records';
+import { ScopeInterface, ProviderRegistryInterface, AppRegistryInterface, AuthRegistryInterface, FrontMcpAuth, Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface } from '../interfaces';
+import { FlowName, ScopeMetadata } from '../metadata';
+export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {
+    abstract readonly id: string;
+    abstract readonly entryPath: string;
+    abstract readonly routeBase: string;
+    abstract readonly logger: FrontMcpLogger;
+    abstract get auth(): FrontMcpAuth;
+    abstract get authProviders(): AuthRegistryInterface;
+    abstract get providers(): ProviderRegistryInterface;
+    abstract get apps(): AppRegistryInterface;
+    abstract get tools(): ToolRegistryInterface;
+    abstract registryFlows(...flows: FlowType[]): Promise<void>;
+    abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
+}

package/src/entries/scope.entry.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class ScopeEntry extends base_entry_1.BaseEntry {
+}
+exports.ScopeEntry = ScopeEntry;
+//# sourceMappingURL=scope.entry.js.map

package/src/entries/scope.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.entry.js","sourceRoot":"","sources":["../../../src/entries/scope.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAYvC,MAAsB,UAAW,SAAQ,sBAAqD;CAmB7F;AAnBD,gCAmBC","sourcesContent":["import {BaseEntry} from './base.entry';\nimport {ScopeRecord} from '../records';\nimport {\n  ScopeInterface,\n  ProviderRegistryInterface,\n  AppRegistryInterface,\n  AuthRegistryInterface,\n  FrontMcpAuth,\n  Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface,\n} from '../interfaces';\nimport {FlowName, ScopeMetadata} from '../metadata';\n\nexport abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {\n  abstract readonly id: string;\n  abstract readonly entryPath: string;\n  abstract readonly routeBase: string;\n  abstract readonly logger: FrontMcpLogger;\n\n  abstract get auth(): FrontMcpAuth;\n\n  abstract get authProviders(): AuthRegistryInterface;\n\n  abstract get providers(): ProviderRegistryInterface;\n\n  abstract get apps(): AppRegistryInterface;\n\n  abstract get tools(): ToolRegistryInterface;\n\n  abstract registryFlows(...flows: FlowType[]): Promise<void>;\n\n  abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;\n}\n"]}

package/src/entries/tool.entry.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { BaseEntry, EntryOwnerRef } from './base.entry';
+import { ToolRecord } from '../records';
+import { ToolContext } from '../interfaces';
+import { ToolMetadata } from '../metadata';
+import { Request, Notification, CallToolRequest } from "@modelcontextprotocol/sdk/types.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+export type ToolCallArgs = CallToolRequest["params"]["arguments"];
+export type ToolCallExtra = RequestHandlerExtra<Request, Notification>;
+export declare abstract class ToolEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ToolRecord, ToolContext<In, Out>, ToolMetadata> {
+    owner: EntryOwnerRef;
+    inputSchema: z.ZodObject<any>;
+    outputSchema: z.ZodObject<any>;
+    abstract create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<In, Out>;
+}

package/src/entries/tool.entry.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class ToolEntry extends base_entry_1.BaseEntry {
+    owner;
+    inputSchema;
+    outputSchema;
+}
+exports.ToolEntry = ToolEntry;
+//# sourceMappingURL=tool.entry.js.map

package/src/entries/tool.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.entry.js","sourceRoot":"","sources":["../../../src/entries/tool.entry.ts"],"names":[],"mappings":";;;AACA,6CAAsD;AAWtD,MAAsB,SAAmD,SAAQ,sBAAyD;IACxI,KAAK,CAAgB;IACrB,WAAW,CAAmB;IAC9B,YAAY,CAAmB;CAGhC;AAND,8BAMC","sourcesContent":["import {z} from 'zod';\nimport {BaseEntry, EntryOwnerRef} from './base.entry';\nimport {ToolRecord} from '../records';\nimport {ToolContext} from '../interfaces';\nimport {ToolMetadata} from '../metadata';\nimport {Request, Notification, CallToolRequest} from \"@modelcontextprotocol/sdk/types.js\";\nimport {RequestHandlerExtra} from \"@modelcontextprotocol/sdk/shared/protocol.js\";\n\n\nexport type ToolCallArgs = CallToolRequest[\"params\"][\"arguments\"];\nexport type ToolCallExtra = RequestHandlerExtra<Request, Notification>;\n\nexport abstract class ToolEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ToolRecord, ToolContext<In, Out>, ToolMetadata> {\n  owner: EntryOwnerRef;\n  inputSchema: z.ZodObject<any>;\n  outputSchema: z.ZodObject<any>;\n\n  abstract create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<In, Out>;\n}\n"]}

package/src/index.d.ts

@@ -0,0 +1,18 @@
+export * from './constants';
+export * from './decorators';
+export * from './types';
+export * from './metadata';
+export * from './interfaces';
+export * from './tokens';
+export * from './dynamic';
+export * from './records';
+export * from './entries';
+export * from './utils';
+export * from './schemas';
+export * from './decorators-old/async-with.decorator';
+export * from './decorators-old/tool-hook.decorator';
+export * from './decorators-old/session-hook.decorator';
+export * from './interfaces/tool-hook.interface';
+export * from './interfaces/session-hook.interface';
+export * from './interfaces/auth-hook.interface';
+export * from './providers/session.provider';

package/src/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./constants"), exports);
+tslib_1.__exportStar(require("./decorators"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./metadata"), exports);
+tslib_1.__exportStar(require("./interfaces"), exports);
+tslib_1.__exportStar(require("./tokens"), exports);
+tslib_1.__exportStar(require("./dynamic"), exports);
+tslib_1.__exportStar(require("./records"), exports);
+tslib_1.__exportStar(require("./entries"), exports);
+tslib_1.__exportStar(require("./utils"), exports);
+tslib_1.__exportStar(require("./schemas"), exports);
+tslib_1.__exportStar(require("./decorators-old/async-with.decorator"), exports);
+tslib_1.__exportStar(require("./decorators-old/tool-hook.decorator"), exports);
+tslib_1.__exportStar(require("./decorators-old/session-hook.decorator"), exports);
+tslib_1.__exportStar(require("./interfaces/tool-hook.interface"), exports);
+tslib_1.__exportStar(require("./interfaces/session-hook.interface"), exports);
+tslib_1.__exportStar(require("./interfaces/auth-hook.interface"), exports);
+tslib_1.__exportStar(require("./providers/session.provider"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,uDAA6B;AAC7B,mDAAyB;AACzB,oDAA0B;AAC1B,oDAA0B;AAC1B,oDAA0B;AAC1B,kDAAwB;AACxB,oDAA0B;AAE1B,gFAAsD;AACtD,+EAAqD;AACrD,kFAAwD;AAExD,2EAAiD;AACjD,8EAAoD;AACpD,2EAAiD;AAGjD,uEAA6C","sourcesContent":["export * from './constants';\nexport * from './decorators';\nexport * from './types';\nexport * from './metadata';\nexport * from './interfaces';\nexport * from './tokens';\nexport * from './dynamic';\nexport * from './records';\nexport * from './entries';\nexport * from './utils';\nexport * from './schemas';\n\nexport * from './decorators-old/async-with.decorator';\nexport * from './decorators-old/tool-hook.decorator';\nexport * from './decorators-old/session-hook.decorator';\n\nexport * from './interfaces/tool-hook.interface';\nexport * from './interfaces/session-hook.interface';\nexport * from './interfaces/auth-hook.interface';\n\n\nexport * from './providers/session.provider';\n\n\n"]}

package/src/interfaces/adapter.interface.d.ts

@@ -0,0 +1,20 @@
+import { ClassType, FactoryType, Token, Type, ValueType } from './base.interface';
+import { ToolType } from './tool.interface';
+import { ResourceType } from './resource.interface';
+import { PromptType } from './prompt.interface';
+import { AdapterMetadata } from '../metadata';
+export interface AdapterInterface {
+    options: {
+        name: string;
+    } & Record<string, unknown>;
+    fetch: () => Promise<FrontMcpAdapterResponse> | FrontMcpAdapterResponse;
+}
+export interface FrontMcpAdapterResponse {
+    tools?: ToolType[];
+    resources?: ResourceType[];
+    prompts?: PromptType[];
+}
+export type AdapterClassType<Provide> = ClassType<Provide> & AdapterMetadata;
+export type AdapterValueType<Provide> = ValueType<Provide> & AdapterMetadata;
+export type AdapterFactoryType<Provide, Tokens extends readonly Token[]> = FactoryType<Provide, Tokens> & AdapterMetadata;
+export type AdapterType<Provide extends AdapterInterface = any> = Type<Provide> | AdapterClassType<Provide> | AdapterValueType<Provide> | AdapterFactoryType<Provide, any[]>;

package/src/interfaces/adapter.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=adapter.interface.js.map

package/src/interfaces/adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.interface.js","sourceRoot":"","sources":["../../../src/interfaces/adapter.interface.ts"],"names":[],"mappings":"","sourcesContent":["import {ClassType, FactoryType, Token, Type, ValueType} from './base.interface';\nimport {ToolType} from './tool.interface';\nimport {ResourceType} from './resource.interface';\nimport {PromptType} from './prompt.interface';\nimport {AdapterMetadata} from '../metadata';\n\nexport interface AdapterInterface {\n  options: { name: string } & Record<string, unknown>;\n  fetch: () => Promise<FrontMcpAdapterResponse> | FrontMcpAdapterResponse;\n}\n\nexport interface FrontMcpAdapterResponse {\n  tools?: ToolType[];\n  resources?: ResourceType[];\n  prompts?: PromptType[];\n}\n\n\nexport type AdapterClassType<Provide> = ClassType<Provide> & AdapterMetadata;\nexport type AdapterValueType<Provide> = ValueType<Provide> & AdapterMetadata;\nexport type AdapterFactoryType<Provide, Tokens extends readonly Token[]> =\n  FactoryType<Provide, Tokens>\n  & AdapterMetadata;\n\n\nexport type AdapterType<Provide extends AdapterInterface = any> =\n  | Type<Provide>\n  | AdapterClassType<Provide>\n  | AdapterValueType<Provide>\n  | AdapterFactoryType<Provide, any[]>\n\n"]}

package/src/interfaces/app.interface.d.ts

@@ -0,0 +1,6 @@
+import { Type, ValueType } from './base.interface';
+import { AppMetadata } from '../metadata';
+export interface AppInterface {
+}
+export type AppValueType<Provide> = ValueType<Provide> & AppMetadata;
+export type AppType<T extends AppInterface = any> = Type<T> | AppValueType<T>;

package/src/interfaces/app.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=app.interface.js.map

package/src/interfaces/app.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.interface.js","sourceRoot":"","sources":["../../../src/interfaces/app.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { Type, ValueType } from './base.interface';\nimport { AppMetadata } from '../metadata';\n\nexport interface AppInterface {\n\n}\n\nexport type AppValueType<Provide> = ValueType<Provide> & AppMetadata;\n\nexport type AppType<T extends AppInterface = any> =\n  | Type<T>\n  | AppValueType<T>"]}

package/src/interfaces/auth-hook.interface.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Lifecycle stages for auth invocation.
+ *
+ * Ordering notes:
+ * - "will*" stages run before the action; "did*" stages run after.
+ * - Higher `priority()` runs earlier for "will*" (outermost), and later for "did*".
+ * - Finalization stages (`willFinalize`, `willAudit`, `didAudit`, `onMetrics`) should be placed
+ *   in your plan’s `finalize` array to run on both success and error paths.
+ *
+ * Control flow:
+ * - Hooks may call `ctx.respond(value)` to short-circuit with a return value.
+ * - Hooks may call `ctx.abort(reason, code?, httpStatus?)` to stop with an error.
+ *
+ */
+export declare enum AuthHookStage {
+    /** Prepare a new session (or re-register an incoming secureJwt).
+     * Responsibilities:
+     * - Validate incoming token (if any); compute defaults; attach user hints.
+     * - Initialize per-session resources and attach to `ctx.data`.
+     * Failure modes:
+     * - `ctx.abort('invalid jwt', 'INVALID_SESSION', 401)`.
+     */
+    willCreateSession = "willCreateSession",
+    /** Session created and registered.
+     * Responsibilities:
+     * - Announce readiness (mount handlers/streams), emit side-effects if needed.
+     * - Optionally shape `ctx.output` with a `SessionContextView`.
+     */
+    didCreateSession = "didCreateSession",
+    /** Bind DI providers needed for this session/request.
+     * Responsibilities:
+     * - Resolve and bind providers so later hooks can `ctx.get(...)`.
+     * - May set `ctx.bindProvider/bindProviders` helpers.
+     */
+    willBindProviders = "willBindProviders",
+    /** Signal the beginning of an auth sequence in the scope of this session.
+     * Responsibilities:
+     * - Initialize auth-related state (PKCE/state, CSRF, telemetry).
+     * - Decide transport (SSE/StreamableHTTP) for status/URL events if applicable.
+     */
+    willBeginAuth = "willBeginAuth",
+    /** Streamable authorization progress within the session.
+     * Responsibilities:
+     * - Emit URL/status events (e.g., “authorize_url”, “awaiting_callback”).
+     * - Optionally `ctx.respond({event: ...})` for push-style transports.
+     */
+    willAuthorize = "willAuthorize",// stream-able events (URL/status)
+    /** Prepare and gate the token exchange with the provider.
+     * Responsibilities:
+     * - Verify callback params; ensure prerequisites (sessionId present).
+     * - Compute exchange request; rate-limit/anti-replay checks.
+     * Failure modes:
+     * - `ctx.abort('invalid state/pkce', 'OAUTH_CALLBACK_ERROR', 400)`.
+     */
+    willExchangeToken = "willExchangeToken",
+    /** SecureMcp JWT has been minted/confirmed for this session.
+     * Responsibilities:
+     * - React to issuance (e.g., persist session claims, notify listeners).
+     * Notes:
+     * - Fired once the session’s secureJwt is known; avoid logging secrets.
+     */
+    didIssueSecureJwt = "didIssueSecureJwt",
+    /** Encrypt and store provider tokens for this session.
+     * Responsibilities:
+     * - Write encrypted blobs to the session record (per provider).
+     * - Derive minimal metadata (scopes/expiry) for later claims-only exposure.
+     */
+    willStoreTokens = "willStoreTokens",
+    /** Authorize and prepare a session read.
+     * Responsibilities:
+     * - Validate access to the session; attach read-scoped providers if required.
+     * - Optionally shape a partial view before execute.
+     */
+    willGetSession = "willGetSession",
+    /** Post-process the session view.
+     * Responsibilities:
+     * - Redact/transform/derive fields for the final response.
+     * - Set `ctx.output` to a `SessionContextView`.
+     */
+    didGetSession = "didGetSession",
+    /** Announce shutdown and allow flush/cleanup.
+     * Responsibilities:
+     * - Close streams, unsubscribe listeners, schedule disposers.
+     */
+    willDisposeSession = "willDisposeSession",
+    /** Confirm teardown and emit metrics.
+     * Responsibilities:
+     * - Final confirmation of resource release; summarize outcome.
+     */
+    didDisposeSession = "didDisposeSession",
+    /** Optional “late finally” hook if you need a single place before audit/metrics.
+     * Responsibilities:
+     * - Last-chance cleanup across success/error paths (idempotent, non-throwing).
+     * Notes:
+     * - Include this stage in your plan’s `finalize` array to activate.
+     */
+    willFinalize = "willFinalize",
+    /** Centralized error handler.
+     * Responsibilities:
+     * - Redact sensitive data; map internal errors to public codes.
+     * - Optionally `ctx.respond({ error })` or `ctx.abort(...)`.
+     * Notes:
+     * - Should not throw; runs before audit/metrics finalize.
+     */
+    onError = "onError",
+    /** Pre-audit collection on both success and error paths.
+     * Responsibilities:
+     * - Build audit envelope (actor, sessionId, providers touched).
+     * - Normalize and strip secrets (no raw tokens).
+     */
+    willAudit = "willAudit",
+    /** Persist/emit the audit record.
+     * Responsibilities:
+     * - Write to audit sink(s) with outcome and timings.
+     * - Correlate via `ctx.requestId`/`ctx.sessionId`.
+     */
+    didAudit = "didAudit",
+    /** Telemetry/metrics emission for both success and errors.
+     * Responsibilities:
+     * - Counters & timings (create/get/dispose/auth/exchange/store).
+     * - Error code/tag cardinality kept small for SLOs/alerts.
+     * Constraints:
+     * - Non-throwing; must not alter control flow.
+     */
+    onMetrics = "onMetrics"
+}