@forgeax/engine-dsh 0.0.0-dev.8d955ade1c79
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/README.md +63 -0
- package/cordis.patch.yml +5 -0
- package/dist/.tsbuildinfo +1 -0
- package/dist/__tests__/dsh-host.test.d.ts +16 -0
- package/dist/__tests__/dsh-host.test.d.ts.map +1 -0
- package/dist/__tests__/engine-host.test.d.ts +2 -0
- package/dist/__tests__/engine-host.test.d.ts.map +1 -0
- package/dist/__tests__/engine-preview.test.d.ts +2 -0
- package/dist/__tests__/engine-preview.test.d.ts.map +1 -0
- package/dist/__tests__/intelligence.test.d.ts +2 -0
- package/dist/__tests__/intelligence.test.d.ts.map +1 -0
- package/dist/__tests__/launch-binding-owner.test-d.d.ts +2 -0
- package/dist/__tests__/launch-binding-owner.test-d.d.ts.map +1 -0
- package/dist/__tests__/protocol.test.d.ts +2 -0
- package/dist/__tests__/protocol.test.d.ts.map +1 -0
- package/dist/client.d.ts +12 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/embedded.d.ts +2 -0
- package/dist/embedded.d.ts.map +1 -0
- package/dist/embedded.mjs +220 -0
- package/dist/embedded.mjs.map +1 -0
- package/dist/engine-host.d.ts +43 -0
- package/dist/engine-host.d.ts.map +1 -0
- package/dist/engine-host.mjs +331 -0
- package/dist/engine-host.mjs.map +1 -0
- package/dist/engine-preview.d.ts +12 -0
- package/dist/engine-preview.d.ts.map +1 -0
- package/dist/engine-preview.mjs +70 -0
- package/dist/engine-preview.mjs.map +1 -0
- package/dist/index.d.ts +26 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.mjs +157 -0
- package/dist/index.mjs.map +1 -0
- package/dist/intelligence.d.ts +5 -0
- package/dist/intelligence.d.ts.map +1 -0
- package/dist/intelligence.mjs +60 -0
- package/dist/intelligence.mjs.map +1 -0
- package/dist/protocol.d.ts +59 -0
- package/dist/protocol.d.ts.map +1 -0
- package/dist/protocol.mjs +31 -0
- package/dist/protocol.mjs.map +1 -0
- package/lib/client.js +295 -0
- package/lib/client.js.map +1 -0
- package/package.json +103 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/protocol.ts","../src/engine-host.ts"],"names":[],"mappings":"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","file":"engine-host.mjs","sourcesContent":["export const FEDERATION_PROTOCOL_VERSION = 1 as const;\nexport const FEDERATION_ROUTE_PREFIX = '/forgeax-federation/v1' as const;\n\nexport type FederationBinding = 'attach' | 'external' | 'embedded';\nexport type FederationOwnership = 'lease' | 'instance';\n\nexport interface FederationStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly identity: string;\n readonly ready: true;\n readonly realm: 'dsh';\n readonly capabilities: readonly string[];\n readonly leases: number;\n readonly engine: EngineProjection;\n}\n\nexport type EngineProjection = EngineEndpointProjection | EmbeddedEngineProjection;\n\nexport interface EngineEndpointProjection {\n readonly binding: 'external';\n readonly endpoint: string;\n readonly ready: true;\n}\n\nexport interface EmbeddedEngineProjection {\n readonly binding: 'embedded';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface FederationLease {\n readonly leaseId: string;\n}\n\nexport interface FederationCommunityCapability {\n readonly id: string;\n readonly value: string;\n}\n\nexport interface FederationActivityResult {\n readonly output: string;\n}\n\nexport interface EnginePreviewStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-status';\n readonly binding: 'external';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface EnginePreviewPoll {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-poll';\n}\n\nexport interface EnginePreviewControl {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-control';\n readonly action: 'toggle';\n}\n\nexport type EnginePreviewRequest = EnginePreviewPoll | EnginePreviewControl;\n\nexport function isEnginePreviewRequest(value: unknown): value is EnginePreviewRequest {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;\n if (record.kind === 'forgeax-engine-poll') return true;\n return record.kind === 'forgeax-engine-control' && record.action === 'toggle';\n}\n\nexport function isEnginePreviewStatus(value: unknown): value is EnginePreviewStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.kind === 'forgeax-engine-status' &&\n record.binding === 'external' &&\n record.ready === true &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n\nexport function isFederationStatus(value: unknown): value is FederationStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.realm === 'dsh' &&\n record.ready === true &&\n typeof record.identity === 'string' &&\n Array.isArray(record.capabilities) &&\n record.capabilities.every((capability) => typeof capability === 'string') &&\n Number.isInteger(record.leases) &&\n (record.leases as number) >= 0 &&\n isEngineProjection(record.engine)\n );\n}\n\nfunction isEngineProjection(value: unknown): value is EngineProjection {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.ready !== true) return false;\n if (record.binding === 'external') return typeof record.endpoint === 'string';\n return (\n record.binding === 'embedded' &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n","import { type ChildProcessWithoutNullStreams, spawn } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { delimiter, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { Plugin } from '@forgeax/engine-plugin';\nimport { err, ok, type Result } from '@forgeax/engine-types';\n\nimport {\n FEDERATION_PROTOCOL_VERSION,\n FEDERATION_ROUTE_PREFIX,\n type FederationActivityResult,\n type FederationBinding,\n type FederationCommunityCapability,\n type FederationLease,\n type FederationOwnership,\n type FederationStatus,\n isFederationStatus,\n} from './protocol';\n\ndeclare module '@forgeax/engine-plugin' {\n interface EngineContextServices {\n dshRealm: DshRealmConnection;\n }\n}\n\nexport type DshRealmErrorCode =\n | 'dsh-target-unavailable'\n | 'dsh-target-incompatible'\n | 'dsh-launch-failed'\n | 'dsh-handshake-timeout'\n | 'dsh-lease-failed'\n | 'dsh-community-failed';\n\nexport class DshRealmError extends Error {\n readonly code: DshRealmErrorCode;\n readonly expected: string;\n readonly hint: string;\n readonly detail: Readonly<Record<string, unknown>>;\n\n constructor(\n code: DshRealmErrorCode,\n expected: string,\n hint: string,\n detail: Readonly<Record<string, unknown>>,\n cause?: unknown,\n ) {\n super(`${code}: ${expected}`, cause === undefined ? undefined : { cause });\n this.name = 'DshRealmError';\n this.code = code;\n this.expected = expected;\n this.hint = hint;\n this.detail = detail;\n }\n}\n\nexport interface DshRealmPluginOptions {\n /** Attach to an already-running compatible DSH realm. Never closes that realm. */\n readonly endpoint?: string;\n /** Explicit DSH executable. Omit to discover `dsh` on PATH. */\n readonly executable?: string;\n readonly profile?: string;\n readonly home?: string;\n readonly cwd?: string;\n readonly handshakeTimeoutMs?: number;\n readonly allowEmbedded?: boolean;\n}\n\nexport interface DshRealmConnection {\n readonly endpoint: string;\n readonly binding: FederationBinding;\n readonly ownership: FederationOwnership;\n readonly status: FederationStatus;\n community(): Promise<FederationCommunityCapability>;\n activity(\n input: string,\n sessionId: string,\n signal?: AbortSignal,\n ): Promise<FederationActivityResult>;\n}\n\nexport interface ConnectedRealm {\n readonly connection: DshRealmConnection;\n dispose(): Promise<void>;\n}\n\n/** Engine-side Realm Host Plugin. It publishes no service until handshake and lease acquisition succeed. */\nexport function dshRealmPlugin(options: DshRealmPluginOptions = {}): Plugin {\n return {\n name: 'dsh-realm',\n provide: 'dshRealm',\n async apply(ctx) {\n const result = await connectDshRealm(options);\n if (!result.ok) throw result.error;\n const connected = result.value;\n ctx.effect(() => () => connected.dispose(), 'dsh-realm: binding ownership');\n ctx.provide('dshRealm', connected.connection);\n },\n };\n}\n\nexport async function connectDshRealm(\n options: DshRealmPluginOptions = {},\n): Promise<Result<ConnectedRealm, DshRealmError>> {\n try {\n return ok(await resolveDshRealm(options));\n } catch (cause) {\n if (cause instanceof DshRealmError) return err(cause);\n return err(\n new DshRealmError(\n 'dsh-launch-failed',\n 'the DSH realm binding to initialize',\n 'Inspect the selected endpoint, executable, profile, and process diagnostics.',\n { binding: options.endpoint === undefined ? 'launch' : 'attach' },\n cause,\n ),\n );\n }\n}\n\nasync function resolveDshRealm(options: DshRealmPluginOptions): Promise<ConnectedRealm> {\n const timeoutMs = options.handshakeTimeoutMs ?? 10_000;\n if (options.endpoint !== undefined) {\n return attach(options.endpoint, timeoutMs);\n }\n\n const executable =\n options.executable === undefined ? await discoverOnPath('dsh') : options.executable;\n if (executable !== undefined) {\n return launchExternal(executable, options, timeoutMs);\n }\n if (options.allowEmbedded === false) {\n throw new DshRealmError(\n 'dsh-target-unavailable',\n 'a compatible explicit endpoint or local dsh executable',\n 'Install DeepSeek Harness, pass executable/endpoint, or allow the packaged minimum fallback.',\n { binding: 'external' },\n );\n }\n return launchEmbedded(timeoutMs);\n}\n\nasync function attach(endpoint: string, timeoutMs: number): Promise<ConnectedRealm> {\n const normalized = normalizeEndpoint(endpoint);\n const status = await waitForStatus(normalized, timeoutMs, 'attach');\n const leaseId = await acquireLease(normalized);\n let disposed = false;\n return {\n connection: connection(normalized, 'attach', 'lease', status),\n async dispose() {\n if (disposed) return;\n disposed = true;\n await releaseLease(normalized, leaseId);\n },\n };\n}\n\nasync function launchExternal(\n executable: string,\n options: DshRealmPluginOptions,\n timeoutMs: number,\n): Promise<ConnectedRealm> {\n const args = ['--profile', options.profile ?? 'web', '--host', '127.0.0.1', '--port', '0'];\n const child = spawn(executable, args, {\n cwd: options.cwd,\n env: {\n ...process.env,\n ...(options.home === undefined ? {} : { DSH_HOME: options.home }),\n },\n });\n return finishLaunch(child, 'external', timeoutMs, executable);\n}\n\nasync function launchEmbedded(timeoutMs: number): Promise<ConnectedRealm> {\n const entry = fileURLToPath(new URL('./embedded.mjs', import.meta.url));\n const child = spawn(process.execPath, [entry], { env: process.env });\n return finishLaunch(child, 'embedded', timeoutMs, entry);\n}\n\nasync function finishLaunch(\n child: ChildProcessWithoutNullStreams,\n binding: Exclude<FederationBinding, 'attach'>,\n timeoutMs: number,\n target: string,\n): Promise<ConnectedRealm> {\n try {\n const endpoint = await readLaunchEndpoint(child, timeoutMs, target);\n const status = await waitForStatus(endpoint, timeoutMs, binding);\n const leaseId = await acquireLease(endpoint);\n let disposed = false;\n return {\n connection: connection(endpoint, binding, 'instance', status),\n async dispose() {\n if (disposed) return;\n disposed = true;\n await releaseLease(endpoint, leaseId).catch(() => undefined);\n await stopChild(child);\n },\n };\n } catch (error) {\n await stopChild(child);\n throw error;\n }\n}\n\nfunction connection(\n endpoint: string,\n binding: FederationBinding,\n ownership: FederationOwnership,\n status: FederationStatus,\n): DshRealmConnection {\n return {\n endpoint,\n binding,\n ownership,\n status,\n async community() {\n const response = await fetch(`${endpoint}${FEDERATION_ROUTE_PREFIX}/community`);\n if (!response.ok) {\n throw new DshRealmError(\n 'dsh-community-failed',\n 'the DSH-native community capability to answer through the bridge',\n 'Install and enable a DSH plugin that provides forgeaxFederationCapability.',\n { endpoint, status: response.status },\n );\n }\n return (await response.json()) as FederationCommunityCapability;\n },\n async activity(input, sessionId, signal) {\n const response = await fetch(`${endpoint}${FEDERATION_ROUTE_PREFIX}/activity`, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({ input, sessionId }),\n ...(signal === undefined ? {} : { signal }),\n });\n if (!response.ok) {\n throw new DshRealmError(\n 'dsh-community-failed',\n 'a DSH-native intelligence capability to answer through the bridge',\n 'Install and enable a DSH plugin that provides forgeaxIntelligenceCapability.',\n { endpoint, status: response.status },\n );\n }\n const value = (await response.json()) as Partial<FederationActivityResult>;\n if (typeof value.output !== 'string') {\n throw new DshRealmError(\n 'dsh-community-failed',\n 'the DSH intelligence bridge to return text output',\n 'Use a capability plugin compatible with federation protocol 1.',\n { endpoint, received: value },\n );\n }\n return { output: value.output };\n },\n };\n}\n\nasync function waitForStatus(\n endpoint: string,\n timeoutMs: number,\n binding: FederationBinding,\n): Promise<FederationStatus> {\n const deadline = Date.now() + timeoutMs;\n let last: unknown;\n while (Date.now() < deadline) {\n try {\n const response = await fetch(`${endpoint}${FEDERATION_ROUTE_PREFIX}/status`);\n if (response.ok) {\n const value: unknown = await response.json();\n if (!isFederationStatus(value) || value.protocol !== FEDERATION_PROTOCOL_VERSION) {\n throw new DshRealmError(\n 'dsh-target-incompatible',\n `DSH federation protocol ${FEDERATION_PROTOCOL_VERSION}`,\n 'Use a connector version that matches this Engine package.',\n { binding, endpoint, received: value },\n );\n }\n return value;\n }\n last = response.status;\n } catch (error) {\n if (error instanceof DshRealmError) throw error;\n last = error;\n }\n await new Promise((resolve) => setTimeout(resolve, 50));\n }\n throw new DshRealmError(\n 'dsh-handshake-timeout',\n `a ready federation endpoint within ${timeoutMs}ms`,\n 'Install @forgeax/engine-dsh into the selected DSH profile and inspect its native Loader diagnostics.',\n { binding, endpoint, last },\n );\n}\n\nasync function acquireLease(endpoint: string): Promise<string> {\n const response = await fetch(`${endpoint}${FEDERATION_ROUTE_PREFIX}/lease`, { method: 'POST' });\n if (!response.ok) {\n throw new DshRealmError(\n 'dsh-lease-failed',\n 'a lease-scoped bridge activation',\n 'The target must support lease acquisition and release before attach is safe.',\n { endpoint, status: response.status },\n );\n }\n const lease = (await response.json()) as Partial<FederationLease>;\n if (typeof lease.leaseId !== 'string') {\n throw new DshRealmError(\n 'dsh-lease-failed',\n 'a string leaseId',\n 'Update the target connector to the matching protocol version.',\n { endpoint, received: lease },\n );\n }\n return lease.leaseId;\n}\n\nasync function releaseLease(endpoint: string, leaseId: string): Promise<void> {\n await fetch(\n `${endpoint}${FEDERATION_ROUTE_PREFIX}/lease?leaseId=${encodeURIComponent(leaseId)}`,\n { method: 'DELETE' },\n );\n}\n\nfunction readLaunchEndpoint(\n child: ChildProcessWithoutNullStreams,\n timeoutMs: number,\n target: string,\n): Promise<string> {\n return new Promise((resolve, reject) => {\n let output = '';\n const timer = setTimeout(() => {\n cleanup();\n reject(\n new DshRealmError(\n 'dsh-launch-failed',\n 'the launched realm to print its loopback URL',\n 'Inspect the native DSH startup and Loader diagnostics.',\n { target, output },\n ),\n );\n }, timeoutMs);\n const onData = (chunk: Buffer): void => {\n output += chunk.toString('utf8');\n const matched = output.match(/(?:dsh web|forgeax embedded):\\s+(http:\\/\\/127\\.0\\.0\\.1:\\d+)/);\n if (matched?.[1] === undefined) return;\n cleanup();\n resolve(matched[1]);\n };\n const onExit = (code: number | null): void => {\n cleanup();\n reject(\n new DshRealmError(\n 'dsh-launch-failed',\n 'the launched realm to remain alive through readiness',\n 'Inspect the native process output and profile composition.',\n { target, code, output },\n ),\n );\n };\n const onError = (cause: Error): void => {\n cleanup();\n reject(\n new DshRealmError(\n 'dsh-launch-failed',\n 'the selected DSH executable to start',\n 'Pass an executable file that can launch the selected native DSH profile.',\n { target, output },\n cause,\n ),\n );\n };\n const cleanup = (): void => {\n clearTimeout(timer);\n child.stdout.off('data', onData);\n child.stderr.off('data', onData);\n child.off('exit', onExit);\n child.off('error', onError);\n };\n child.stdout.on('data', onData);\n child.stderr.on('data', onData);\n child.once('exit', onExit);\n child.once('error', onError);\n });\n}\n\nasync function stopChild(child: ChildProcessWithoutNullStreams): Promise<void> {\n if (child.exitCode !== null || child.signalCode !== null) return;\n const exited = new Promise<void>((resolve) => child.once('exit', () => resolve()));\n child.kill('SIGTERM');\n const graceful = await Promise.race([\n exited.then(() => true),\n new Promise<false>((resolve) => setTimeout(() => resolve(false), 2_000)),\n ]);\n if (!graceful && child.exitCode === null) {\n child.kill('SIGKILL');\n await exited;\n }\n}\n\nasync function discoverOnPath(name: string): Promise<string | undefined> {\n const paths = process.env.PATH?.split(delimiter) ?? [];\n for (const directory of paths) {\n const candidate = join(directory, name);\n try {\n await access(candidate);\n return candidate;\n } catch {\n // Keep scanning deterministic PATH order.\n }\n }\n return undefined;\n}\n\nfunction normalizeEndpoint(endpoint: string): string {\n return endpoint.endsWith('/') ? endpoint.slice(0, -1) : endpoint;\n}\n"]}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Plugin } from '@forgeax/engine-plugin';
|
|
2
|
+
export interface EnginePreviewPluginOptions {
|
|
3
|
+
readonly window?: Window;
|
|
4
|
+
readonly initialState?: number;
|
|
5
|
+
readonly control?: (state: number) => number | Promise<number>;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Engine-native half of the DSH Web preview bridge. The effect owns one ECS
|
|
9
|
+
* counter system and one postMessage listener; neither exists while disabled.
|
|
10
|
+
*/
|
|
11
|
+
export declare function enginePreviewPlugin(options?: EnginePreviewPluginOptions): Plugin;
|
|
12
|
+
//# sourceMappingURL=engine-preview.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"engine-preview.d.ts","sourceRoot":"","sources":["../src/engine-preview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAQrD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAyDpF"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { Update } from '@forgeax/engine-ecs';
|
|
2
|
+
|
|
3
|
+
// src/engine-preview.ts
|
|
4
|
+
|
|
5
|
+
// src/protocol.ts
|
|
6
|
+
var FEDERATION_PROTOCOL_VERSION = 1;
|
|
7
|
+
function isEnginePreviewRequest(value) {
|
|
8
|
+
if (typeof value !== "object" || value === null) return false;
|
|
9
|
+
const record = value;
|
|
10
|
+
if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;
|
|
11
|
+
if (record.kind === "forgeax-engine-poll") return true;
|
|
12
|
+
return record.kind === "forgeax-engine-control" && record.action === "toggle";
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
// src/engine-preview.ts
|
|
16
|
+
function enginePreviewPlugin(options = {}) {
|
|
17
|
+
return {
|
|
18
|
+
name: "dsh-engine-preview",
|
|
19
|
+
inject: ["world"],
|
|
20
|
+
apply(ctx) {
|
|
21
|
+
const targetWindow = options.window ?? globalThis.window;
|
|
22
|
+
let tick = 0;
|
|
23
|
+
let state = options.initialState ?? 0;
|
|
24
|
+
const systemName = "dsh-engine-preview-tick";
|
|
25
|
+
ctx.effect(() => {
|
|
26
|
+
ctx.world.addSystem(Update, {
|
|
27
|
+
name: systemName,
|
|
28
|
+
queries: [],
|
|
29
|
+
fn: () => {
|
|
30
|
+
tick += 1;
|
|
31
|
+
}
|
|
32
|
+
}).unwrap();
|
|
33
|
+
const respond = (event, value) => {
|
|
34
|
+
if (event.source === null) return;
|
|
35
|
+
const origin = event.origin === "null" ? "*" : event.origin;
|
|
36
|
+
event.source.postMessage(value, { targetOrigin: origin });
|
|
37
|
+
};
|
|
38
|
+
const snapshot = () => ({
|
|
39
|
+
protocol: FEDERATION_PROTOCOL_VERSION,
|
|
40
|
+
kind: "forgeax-engine-status",
|
|
41
|
+
binding: "external",
|
|
42
|
+
ready: true,
|
|
43
|
+
frameId: tick,
|
|
44
|
+
tick,
|
|
45
|
+
state
|
|
46
|
+
});
|
|
47
|
+
const onMessage = (event) => {
|
|
48
|
+
if (!isEnginePreviewRequest(event.data)) return;
|
|
49
|
+
if (event.data.kind === "forgeax-engine-poll") {
|
|
50
|
+
respond(event, snapshot());
|
|
51
|
+
return;
|
|
52
|
+
}
|
|
53
|
+
Promise.resolve(options.control?.(state) ?? (state === 0 ? 1 : 0)).then((next) => {
|
|
54
|
+
state = next;
|
|
55
|
+
respond(event, snapshot());
|
|
56
|
+
}).catch(() => void 0);
|
|
57
|
+
};
|
|
58
|
+
targetWindow.addEventListener("message", onMessage);
|
|
59
|
+
return () => {
|
|
60
|
+
targetWindow.removeEventListener("message", onMessage);
|
|
61
|
+
ctx.world.removeSystem(Update, systemName).unwrap();
|
|
62
|
+
};
|
|
63
|
+
}, "dsh-engine-preview: tick and message bridge");
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export { enginePreviewPlugin };
|
|
69
|
+
//# sourceMappingURL=engine-preview.mjs.map
|
|
70
|
+
//# sourceMappingURL=engine-preview.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/protocol.ts","../src/engine-preview.ts"],"names":[],"mappings":"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","file":"engine-preview.mjs","sourcesContent":["export const FEDERATION_PROTOCOL_VERSION = 1 as const;\nexport const FEDERATION_ROUTE_PREFIX = '/forgeax-federation/v1' as const;\n\nexport type FederationBinding = 'attach' | 'external' | 'embedded';\nexport type FederationOwnership = 'lease' | 'instance';\n\nexport interface FederationStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly identity: string;\n readonly ready: true;\n readonly realm: 'dsh';\n readonly capabilities: readonly string[];\n readonly leases: number;\n readonly engine: EngineProjection;\n}\n\nexport type EngineProjection = EngineEndpointProjection | EmbeddedEngineProjection;\n\nexport interface EngineEndpointProjection {\n readonly binding: 'external';\n readonly endpoint: string;\n readonly ready: true;\n}\n\nexport interface EmbeddedEngineProjection {\n readonly binding: 'embedded';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface FederationLease {\n readonly leaseId: string;\n}\n\nexport interface FederationCommunityCapability {\n readonly id: string;\n readonly value: string;\n}\n\nexport interface FederationActivityResult {\n readonly output: string;\n}\n\nexport interface EnginePreviewStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-status';\n readonly binding: 'external';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface EnginePreviewPoll {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-poll';\n}\n\nexport interface EnginePreviewControl {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-control';\n readonly action: 'toggle';\n}\n\nexport type EnginePreviewRequest = EnginePreviewPoll | EnginePreviewControl;\n\nexport function isEnginePreviewRequest(value: unknown): value is EnginePreviewRequest {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;\n if (record.kind === 'forgeax-engine-poll') return true;\n return record.kind === 'forgeax-engine-control' && record.action === 'toggle';\n}\n\nexport function isEnginePreviewStatus(value: unknown): value is EnginePreviewStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.kind === 'forgeax-engine-status' &&\n record.binding === 'external' &&\n record.ready === true &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n\nexport function isFederationStatus(value: unknown): value is FederationStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.realm === 'dsh' &&\n record.ready === true &&\n typeof record.identity === 'string' &&\n Array.isArray(record.capabilities) &&\n record.capabilities.every((capability) => typeof capability === 'string') &&\n Number.isInteger(record.leases) &&\n (record.leases as number) >= 0 &&\n isEngineProjection(record.engine)\n );\n}\n\nfunction isEngineProjection(value: unknown): value is EngineProjection {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.ready !== true) return false;\n if (record.binding === 'external') return typeof record.endpoint === 'string';\n return (\n record.binding === 'embedded' &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n","import { Update } from '@forgeax/engine-ecs';\nimport type { Plugin } from '@forgeax/engine-plugin';\n\nimport {\n type EnginePreviewStatus,\n FEDERATION_PROTOCOL_VERSION,\n isEnginePreviewRequest,\n} from './protocol';\n\nexport interface EnginePreviewPluginOptions {\n readonly window?: Window;\n readonly initialState?: number;\n readonly control?: (state: number) => number | Promise<number>;\n}\n\n/**\n * Engine-native half of the DSH Web preview bridge. The effect owns one ECS\n * counter system and one postMessage listener; neither exists while disabled.\n */\nexport function enginePreviewPlugin(options: EnginePreviewPluginOptions = {}): Plugin {\n return {\n name: 'dsh-engine-preview',\n inject: ['world'],\n apply(ctx) {\n const targetWindow = options.window ?? globalThis.window;\n let tick = 0;\n let state = options.initialState ?? 0;\n const systemName = 'dsh-engine-preview-tick';\n\n ctx.effect(() => {\n ctx.world\n .addSystem(Update, {\n name: systemName,\n queries: [],\n fn: () => {\n tick += 1;\n },\n })\n .unwrap();\n\n const respond = (event: MessageEvent, value: EnginePreviewStatus): void => {\n if (event.source === null) return;\n const origin = event.origin === 'null' ? '*' : event.origin;\n (event.source as WindowProxy).postMessage(value, { targetOrigin: origin });\n };\n const snapshot = (): EnginePreviewStatus => ({\n protocol: FEDERATION_PROTOCOL_VERSION,\n kind: 'forgeax-engine-status',\n binding: 'external',\n ready: true,\n frameId: tick,\n tick,\n state,\n });\n const onMessage = (event: MessageEvent): void => {\n if (!isEnginePreviewRequest(event.data)) return;\n if (event.data.kind === 'forgeax-engine-poll') {\n respond(event, snapshot());\n return;\n }\n Promise.resolve(options.control?.(state) ?? (state === 0 ? 1 : 0))\n .then((next) => {\n state = next;\n respond(event, snapshot());\n })\n .catch(() => undefined);\n };\n targetWindow.addEventListener('message', onMessage);\n\n return () => {\n targetWindow.removeEventListener('message', onMessage);\n ctx.world.removeSystem(Update, systemName).unwrap();\n };\n }, 'dsh-engine-preview: tick and message bridge');\n },\n };\n}\n"]}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
interface WebRoute {
|
|
3
|
+
readonly kind: 'exact' | 'prefix';
|
|
4
|
+
readonly path: string;
|
|
5
|
+
readonly handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
|
|
6
|
+
}
|
|
7
|
+
interface WebServerService {
|
|
8
|
+
register(route: WebRoute): () => void;
|
|
9
|
+
}
|
|
10
|
+
interface DshHostContext {
|
|
11
|
+
readonly webServer: WebServerService;
|
|
12
|
+
readonly logger: {
|
|
13
|
+
warn(error: unknown): void;
|
|
14
|
+
};
|
|
15
|
+
effect(callback: () => void | (() => void | Promise<void>), label?: string): void;
|
|
16
|
+
get(name: string): unknown;
|
|
17
|
+
}
|
|
18
|
+
export interface Config {
|
|
19
|
+
readonly engineEndpoint?: string;
|
|
20
|
+
readonly identity?: string;
|
|
21
|
+
}
|
|
22
|
+
export declare const inject: string[];
|
|
23
|
+
/** DSH-native Host half. DSH's Loader mounts this ordinary plugin from the package patch. */
|
|
24
|
+
export declare function apply(ctx: DshHostContext, config?: Config): Promise<void>;
|
|
25
|
+
export {};
|
|
26
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAajE,UAAU,QAAQ;IAChB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChG;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CACvC;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAChD,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAaD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,MAAM,UAAgB,CAAC;AAEpC,6FAA6F;AAC7F,wBAAsB,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6InF"}
|
package/dist/index.mjs
ADDED
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import { randomUUID } from 'crypto';
|
|
2
|
+
import { World, createWorldContext, Update } from '@forgeax/engine-ecs';
|
|
3
|
+
|
|
4
|
+
// src/index.ts
|
|
5
|
+
|
|
6
|
+
// src/protocol.ts
|
|
7
|
+
var FEDERATION_PROTOCOL_VERSION = 1;
|
|
8
|
+
var FEDERATION_ROUTE_PREFIX = "/forgeax-federation/v1";
|
|
9
|
+
|
|
10
|
+
// src/index.ts
|
|
11
|
+
var inject = ["webServer"];
|
|
12
|
+
async function apply(ctx, config = {}) {
|
|
13
|
+
const identity = config.identity ?? `dsh-${randomUUID()}`;
|
|
14
|
+
const leases = /* @__PURE__ */ new Set();
|
|
15
|
+
let tick = 0;
|
|
16
|
+
let state = 0;
|
|
17
|
+
let embeddedContext;
|
|
18
|
+
let timer;
|
|
19
|
+
const disposers = [];
|
|
20
|
+
let disposed = false;
|
|
21
|
+
ctx.effect(
|
|
22
|
+
() => async () => {
|
|
23
|
+
if (disposed) return;
|
|
24
|
+
disposed = true;
|
|
25
|
+
for (const dispose of disposers.reverse()) dispose();
|
|
26
|
+
leases.clear();
|
|
27
|
+
if (timer !== void 0) clearInterval(timer);
|
|
28
|
+
await embeddedContext?.fiber.dispose();
|
|
29
|
+
},
|
|
30
|
+
"forgeax-federation: routes and embedded engine"
|
|
31
|
+
);
|
|
32
|
+
if (config.engineEndpoint === void 0) {
|
|
33
|
+
const world = new World();
|
|
34
|
+
embeddedContext = await createWorldContext(world);
|
|
35
|
+
world.addSystem(Update, {
|
|
36
|
+
name: "forgeax-federation-headless-tick",
|
|
37
|
+
queries: [],
|
|
38
|
+
fn: () => {
|
|
39
|
+
tick += 1;
|
|
40
|
+
}
|
|
41
|
+
}).unwrap();
|
|
42
|
+
timer = setInterval(() => {
|
|
43
|
+
const result = world.update(1 / 30);
|
|
44
|
+
if (!result.ok) ctx.logger.warn(result.error);
|
|
45
|
+
}, 1e3 / 30);
|
|
46
|
+
}
|
|
47
|
+
const status = () => ({
|
|
48
|
+
protocol: FEDERATION_PROTOCOL_VERSION,
|
|
49
|
+
identity,
|
|
50
|
+
ready: true,
|
|
51
|
+
realm: "dsh",
|
|
52
|
+
capabilities: ["lease", "community-probe", "engine-projection"],
|
|
53
|
+
leases: leases.size,
|
|
54
|
+
engine: config.engineEndpoint === void 0 ? { binding: "embedded", ready: true, frameId: tick, tick, state } : { binding: "external", endpoint: config.engineEndpoint, ready: true }
|
|
55
|
+
});
|
|
56
|
+
disposers.push(
|
|
57
|
+
ctx.webServer.register({
|
|
58
|
+
kind: "exact",
|
|
59
|
+
path: `${FEDERATION_ROUTE_PREFIX}/status`,
|
|
60
|
+
handler(_request, response) {
|
|
61
|
+
writeJson(response, 200, status());
|
|
62
|
+
}
|
|
63
|
+
}),
|
|
64
|
+
ctx.webServer.register({
|
|
65
|
+
kind: "exact",
|
|
66
|
+
path: `${FEDERATION_ROUTE_PREFIX}/activity`,
|
|
67
|
+
async handler(request, response) {
|
|
68
|
+
if (request.method !== "POST") {
|
|
69
|
+
writeJson(response, 405, { code: "federation-method-not-allowed" });
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
const candidate = ctx.get("forgeaxIntelligenceCapability");
|
|
73
|
+
if (candidate === void 0 || typeof candidate.run !== "function") {
|
|
74
|
+
writeJson(response, 404, { code: "federation-intelligence-capability-missing" });
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
const body = await readJsonBody(request);
|
|
78
|
+
if (typeof body !== "object" || body === null || typeof Reflect.get(body, "input") !== "string" || typeof Reflect.get(body, "sessionId") !== "string") {
|
|
79
|
+
writeJson(response, 400, { code: "federation-activity-invalid" });
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
writeJson(
|
|
83
|
+
response,
|
|
84
|
+
200,
|
|
85
|
+
await candidate.run(Reflect.get(body, "input"), Reflect.get(body, "sessionId"))
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
}),
|
|
89
|
+
ctx.webServer.register({
|
|
90
|
+
kind: "exact",
|
|
91
|
+
path: `${FEDERATION_ROUTE_PREFIX}/lease`,
|
|
92
|
+
handler(request, response) {
|
|
93
|
+
if (request.method === "POST") {
|
|
94
|
+
const leaseId = randomUUID();
|
|
95
|
+
leases.add(leaseId);
|
|
96
|
+
writeJson(response, 201, { leaseId });
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
if (request.method === "DELETE") {
|
|
100
|
+
const leaseId = new URL(request.url ?? "/", "http://localhost").searchParams.get(
|
|
101
|
+
"leaseId"
|
|
102
|
+
);
|
|
103
|
+
if (leaseId !== null) leases.delete(leaseId);
|
|
104
|
+
writeJson(response, 200, { released: leaseId !== null });
|
|
105
|
+
return;
|
|
106
|
+
}
|
|
107
|
+
writeJson(response, 405, { code: "federation-method-not-allowed" });
|
|
108
|
+
}
|
|
109
|
+
}),
|
|
110
|
+
ctx.webServer.register({
|
|
111
|
+
kind: "exact",
|
|
112
|
+
path: `${FEDERATION_ROUTE_PREFIX}/community`,
|
|
113
|
+
async handler(_request, response) {
|
|
114
|
+
const candidate = ctx.get("forgeaxFederationCapability");
|
|
115
|
+
if (candidate === void 0 || typeof candidate.inspect !== "function") {
|
|
116
|
+
writeJson(response, 404, { code: "federation-community-capability-missing" });
|
|
117
|
+
return;
|
|
118
|
+
}
|
|
119
|
+
writeJson(response, 200, await candidate.inspect());
|
|
120
|
+
}
|
|
121
|
+
}),
|
|
122
|
+
ctx.webServer.register({
|
|
123
|
+
kind: "exact",
|
|
124
|
+
path: `${FEDERATION_ROUTE_PREFIX}/engine/control`,
|
|
125
|
+
handler(request, response) {
|
|
126
|
+
if (request.method !== "POST" || config.engineEndpoint !== void 0) {
|
|
127
|
+
writeJson(response, 409, { code: "federation-engine-control-unavailable" });
|
|
128
|
+
return;
|
|
129
|
+
}
|
|
130
|
+
state = state === 0 ? 1 : 0;
|
|
131
|
+
writeJson(response, 200, status().engine);
|
|
132
|
+
}
|
|
133
|
+
})
|
|
134
|
+
);
|
|
135
|
+
}
|
|
136
|
+
async function readJsonBody(request) {
|
|
137
|
+
const chunks = [];
|
|
138
|
+
let size = 0;
|
|
139
|
+
for await (const chunk of request) {
|
|
140
|
+
const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
|
|
141
|
+
size += buffer.byteLength;
|
|
142
|
+
if (size > 65536) throw new Error("federation request exceeds 65536 bytes");
|
|
143
|
+
chunks.push(buffer);
|
|
144
|
+
}
|
|
145
|
+
return JSON.parse(Buffer.concat(chunks).toString("utf8"));
|
|
146
|
+
}
|
|
147
|
+
function writeJson(response, status, value) {
|
|
148
|
+
response.writeHead(status, {
|
|
149
|
+
"cache-control": "no-store",
|
|
150
|
+
"content-type": "application/json; charset=utf-8"
|
|
151
|
+
});
|
|
152
|
+
response.end(JSON.stringify(value));
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
export { apply, inject };
|
|
156
|
+
//# sourceMappingURL=index.mjs.map
|
|
157
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/protocol.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export const FEDERATION_PROTOCOL_VERSION = 1 as const;\nexport const FEDERATION_ROUTE_PREFIX = '/forgeax-federation/v1' as const;\n\nexport type FederationBinding = 'attach' | 'external' | 'embedded';\nexport type FederationOwnership = 'lease' | 'instance';\n\nexport interface FederationStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly identity: string;\n readonly ready: true;\n readonly realm: 'dsh';\n readonly capabilities: readonly string[];\n readonly leases: number;\n readonly engine: EngineProjection;\n}\n\nexport type EngineProjection = EngineEndpointProjection | EmbeddedEngineProjection;\n\nexport interface EngineEndpointProjection {\n readonly binding: 'external';\n readonly endpoint: string;\n readonly ready: true;\n}\n\nexport interface EmbeddedEngineProjection {\n readonly binding: 'embedded';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface FederationLease {\n readonly leaseId: string;\n}\n\nexport interface FederationCommunityCapability {\n readonly id: string;\n readonly value: string;\n}\n\nexport interface FederationActivityResult {\n readonly output: string;\n}\n\nexport interface EnginePreviewStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-status';\n readonly binding: 'external';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface EnginePreviewPoll {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-poll';\n}\n\nexport interface EnginePreviewControl {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-control';\n readonly action: 'toggle';\n}\n\nexport type EnginePreviewRequest = EnginePreviewPoll | EnginePreviewControl;\n\nexport function isEnginePreviewRequest(value: unknown): value is EnginePreviewRequest {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;\n if (record.kind === 'forgeax-engine-poll') return true;\n return record.kind === 'forgeax-engine-control' && record.action === 'toggle';\n}\n\nexport function isEnginePreviewStatus(value: unknown): value is EnginePreviewStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.kind === 'forgeax-engine-status' &&\n record.binding === 'external' &&\n record.ready === true &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n\nexport function isFederationStatus(value: unknown): value is FederationStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.realm === 'dsh' &&\n record.ready === true &&\n typeof record.identity === 'string' &&\n Array.isArray(record.capabilities) &&\n record.capabilities.every((capability) => typeof capability === 'string') &&\n Number.isInteger(record.leases) &&\n (record.leases as number) >= 0 &&\n isEngineProjection(record.engine)\n );\n}\n\nfunction isEngineProjection(value: unknown): value is EngineProjection {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.ready !== true) return false;\n if (record.binding === 'external') return typeof record.endpoint === 'string';\n return (\n record.binding === 'embedded' &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n","import { randomUUID } from 'node:crypto';\nimport type { IncomingMessage, ServerResponse } from 'node:http';\n\nimport { createWorldContext, Update, World } from '@forgeax/engine-ecs';\nimport type { Context } from '@forgeax/engine-plugin';\n\nimport {\n FEDERATION_PROTOCOL_VERSION,\n FEDERATION_ROUTE_PREFIX,\n type FederationActivityResult,\n type FederationCommunityCapability,\n type FederationStatus,\n} from './protocol';\n\ninterface WebRoute {\n readonly kind: 'exact' | 'prefix';\n readonly path: string;\n readonly handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;\n}\n\ninterface WebServerService {\n register(route: WebRoute): () => void;\n}\n\ninterface DshHostContext {\n readonly webServer: WebServerService;\n readonly logger: { warn(error: unknown): void };\n effect(callback: () => void | (() => void | Promise<void>), label?: string): void;\n get(name: string): unknown;\n}\n\ninterface CommunityProbeService {\n inspect(): FederationCommunityCapability | Promise<FederationCommunityCapability>;\n}\n\ninterface IntelligenceCapabilityService {\n run(\n input: string,\n sessionId: string,\n ): FederationActivityResult | Promise<FederationActivityResult>;\n}\n\nexport interface Config {\n readonly engineEndpoint?: string;\n readonly identity?: string;\n}\n\nexport const inject = ['webServer'];\n\n/** DSH-native Host half. DSH's Loader mounts this ordinary plugin from the package patch. */\nexport async function apply(ctx: DshHostContext, config: Config = {}): Promise<void> {\n const identity = config.identity ?? `dsh-${randomUUID()}`;\n const leases = new Set<string>();\n let tick = 0;\n let state = 0;\n let embeddedContext: Context | undefined;\n let timer: ReturnType<typeof setInterval> | undefined;\n const disposers: Array<() => void> = [];\n let disposed = false;\n\n ctx.effect(\n () => async () => {\n if (disposed) return;\n disposed = true;\n for (const dispose of disposers.reverse()) dispose();\n leases.clear();\n if (timer !== undefined) clearInterval(timer);\n await embeddedContext?.fiber.dispose();\n },\n 'forgeax-federation: routes and embedded engine',\n );\n\n if (config.engineEndpoint === undefined) {\n const world = new World();\n embeddedContext = await createWorldContext(world);\n world\n .addSystem(Update, {\n name: 'forgeax-federation-headless-tick',\n queries: [],\n fn: () => {\n tick += 1;\n },\n })\n .unwrap();\n timer = setInterval(() => {\n const result = world.update(1 / 30);\n if (!result.ok) ctx.logger.warn(result.error);\n }, 1000 / 30);\n }\n\n const status = (): FederationStatus => ({\n protocol: FEDERATION_PROTOCOL_VERSION,\n identity,\n ready: true,\n realm: 'dsh',\n capabilities: ['lease', 'community-probe', 'engine-projection'],\n leases: leases.size,\n engine:\n config.engineEndpoint === undefined\n ? { binding: 'embedded', ready: true, frameId: tick, tick, state }\n : { binding: 'external', endpoint: config.engineEndpoint, ready: true },\n });\n\n disposers.push(\n ctx.webServer.register({\n kind: 'exact',\n path: `${FEDERATION_ROUTE_PREFIX}/status`,\n handler(_request, response) {\n writeJson(response, 200, status());\n },\n }),\n ctx.webServer.register({\n kind: 'exact',\n path: `${FEDERATION_ROUTE_PREFIX}/activity`,\n async handler(request, response) {\n if (request.method !== 'POST') {\n writeJson(response, 405, { code: 'federation-method-not-allowed' });\n return;\n }\n const candidate = ctx.get('forgeaxIntelligenceCapability') as\n | IntelligenceCapabilityService\n | undefined;\n if (candidate === undefined || typeof candidate.run !== 'function') {\n writeJson(response, 404, { code: 'federation-intelligence-capability-missing' });\n return;\n }\n const body = await readJsonBody(request);\n if (\n typeof body !== 'object' ||\n body === null ||\n typeof Reflect.get(body, 'input') !== 'string' ||\n typeof Reflect.get(body, 'sessionId') !== 'string'\n ) {\n writeJson(response, 400, { code: 'federation-activity-invalid' });\n return;\n }\n writeJson(\n response,\n 200,\n await candidate.run(Reflect.get(body, 'input'), Reflect.get(body, 'sessionId')),\n );\n },\n }),\n ctx.webServer.register({\n kind: 'exact',\n path: `${FEDERATION_ROUTE_PREFIX}/lease`,\n handler(request, response) {\n if (request.method === 'POST') {\n const leaseId = randomUUID();\n leases.add(leaseId);\n writeJson(response, 201, { leaseId });\n return;\n }\n if (request.method === 'DELETE') {\n const leaseId = new URL(request.url ?? '/', 'http://localhost').searchParams.get(\n 'leaseId',\n );\n if (leaseId !== null) leases.delete(leaseId);\n writeJson(response, 200, { released: leaseId !== null });\n return;\n }\n writeJson(response, 405, { code: 'federation-method-not-allowed' });\n },\n }),\n ctx.webServer.register({\n kind: 'exact',\n path: `${FEDERATION_ROUTE_PREFIX}/community`,\n async handler(_request, response) {\n const candidate = ctx.get('forgeaxFederationCapability') as\n | CommunityProbeService\n | undefined;\n if (candidate === undefined || typeof candidate.inspect !== 'function') {\n writeJson(response, 404, { code: 'federation-community-capability-missing' });\n return;\n }\n writeJson(response, 200, await candidate.inspect());\n },\n }),\n ctx.webServer.register({\n kind: 'exact',\n path: `${FEDERATION_ROUTE_PREFIX}/engine/control`,\n handler(request, response) {\n if (request.method !== 'POST' || config.engineEndpoint !== undefined) {\n writeJson(response, 409, { code: 'federation-engine-control-unavailable' });\n return;\n }\n state = state === 0 ? 1 : 0;\n writeJson(response, 200, status().engine);\n },\n }),\n );\n}\n\nasync function readJsonBody(request: IncomingMessage): Promise<unknown> {\n const chunks: Buffer[] = [];\n let size = 0;\n for await (const chunk of request) {\n const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n size += buffer.byteLength;\n if (size > 65_536) throw new Error('federation request exceeds 65536 bytes');\n chunks.push(buffer);\n }\n return JSON.parse(Buffer.concat(chunks).toString('utf8')) as unknown;\n}\n\nfunction writeJson(response: ServerResponse, status: number, value: unknown): void {\n response.writeHead(status, {\n 'cache-control': 'no-store',\n 'content-type': 'application/json; charset=utf-8',\n });\n response.end(JSON.stringify(value));\n}\n"]}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { type IntelligenceProvider } from '@forgeax/engine-intelligence';
|
|
2
|
+
import type { DshRealmConnection } from './engine-host';
|
|
3
|
+
/** Adapt one ready DSH realm bridge to the provider-neutral AI Native Activity contract. */
|
|
4
|
+
export declare function createDshRealmIntelligenceProvider(connection: DshRealmConnection): IntelligenceProvider;
|
|
5
|
+
//# sourceMappingURL=intelligence.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../src/intelligence.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAQxD,4FAA4F;AAC5F,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,kBAAkB,GAC7B,oBAAoB,CAyDtB"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { IntelligenceError } from '@forgeax/engine-intelligence';
|
|
2
|
+
import { err, ok } from '@forgeax/engine-types';
|
|
3
|
+
|
|
4
|
+
// src/intelligence.ts
|
|
5
|
+
function createDshRealmIntelligenceProvider(connection) {
|
|
6
|
+
const running = /* @__PURE__ */ new Map();
|
|
7
|
+
let closed = false;
|
|
8
|
+
return {
|
|
9
|
+
id: "deepseek-harness-federated",
|
|
10
|
+
start(submission, sink) {
|
|
11
|
+
if (closed) {
|
|
12
|
+
return err(new IntelligenceError({ code: "intelligence-closed", detail: {} }));
|
|
13
|
+
}
|
|
14
|
+
const controller = new AbortController();
|
|
15
|
+
const task = run(submission, sink, controller);
|
|
16
|
+
running.set(submission.id, { controller, sink, task });
|
|
17
|
+
return ok(void 0);
|
|
18
|
+
},
|
|
19
|
+
cancel(id) {
|
|
20
|
+
const activity = running.get(id);
|
|
21
|
+
if (activity === void 0) {
|
|
22
|
+
return err(
|
|
23
|
+
new IntelligenceError({
|
|
24
|
+
code: "intelligence-activity-not-found",
|
|
25
|
+
detail: { activityId: id }
|
|
26
|
+
})
|
|
27
|
+
);
|
|
28
|
+
}
|
|
29
|
+
activity.controller.abort();
|
|
30
|
+
return ok(void 0);
|
|
31
|
+
},
|
|
32
|
+
async close() {
|
|
33
|
+
if (closed) return;
|
|
34
|
+
closed = true;
|
|
35
|
+
for (const activity of running.values()) activity.controller.abort();
|
|
36
|
+
await Promise.allSettled([...running.values()].map((activity) => activity.task));
|
|
37
|
+
running.clear();
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
async function run(submission, sink, controller) {
|
|
41
|
+
try {
|
|
42
|
+
const result = await connection.activity(
|
|
43
|
+
submission.input,
|
|
44
|
+
submission.session.id,
|
|
45
|
+
controller.signal
|
|
46
|
+
);
|
|
47
|
+
sink.text(result.output);
|
|
48
|
+
sink.complete(result.output);
|
|
49
|
+
} catch (error) {
|
|
50
|
+
if (controller.signal.aborted) sink.cancelled();
|
|
51
|
+
else sink.fail(error);
|
|
52
|
+
} finally {
|
|
53
|
+
running.delete(submission.id);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export { createDshRealmIntelligenceProvider };
|
|
59
|
+
//# sourceMappingURL=intelligence.mjs.map
|
|
60
|
+
//# sourceMappingURL=intelligence.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/intelligence.ts"],"names":[],"mappings":";;;;AAkBO,SAAS,mCACd,UAAA,EACsB;AACtB,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAiC;AACrD,EAAA,IAAI,MAAA,GAAS,KAAA;AAEb,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,4BAAA;AAAA,IACJ,KAAA,CAAM,YAAY,IAAA,EAAM;AACtB,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,OAAO,GAAA,CAAI,IAAI,iBAAA,CAAkB,EAAE,IAAA,EAAM,uBAAuB,MAAA,EAAQ,EAAC,EAAG,CAAC,CAAA;AAAA,MAC/E;AACA,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,MAAM,IAAA,GAAO,GAAA,CAAI,UAAA,EAAY,IAAA,EAAM,UAAU,CAAA;AAC7C,MAAA,OAAA,CAAQ,IAAI,UAAA,CAAW,EAAA,EAAI,EAAE,UAAA,EAAY,IAAA,EAAM,MAAM,CAAA;AACrD,MAAA,OAAO,GAAG,MAAS,CAAA;AAAA,IACrB,CAAA;AAAA,IACA,OAAO,EAAA,EAAI;AACT,MAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA;AAC/B,MAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,QAAA,OAAO,GAAA;AAAA,UACL,IAAI,iBAAA,CAAkB;AAAA,YACpB,IAAA,EAAM,iCAAA;AAAA,YACN,MAAA,EAAQ,EAAE,UAAA,EAAY,EAAA;AAAG,WAC1B;AAAA,SACH;AAAA,MACF;AACA,MAAA,QAAA,CAAS,WAAW,KAAA,EAAM;AAC1B,MAAA,OAAO,GAAG,MAAS,CAAA;AAAA,IACrB,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AACZ,MAAA,IAAI,MAAA,EAAQ;AACZ,MAAA,MAAA,GAAS,IAAA;AACT,MAAA,KAAA,MAAW,YAAY,OAAA,CAAQ,MAAA,EAAO,EAAG,QAAA,CAAS,WAAW,KAAA,EAAM;AACnE,MAAA,MAAM,OAAA,CAAQ,UAAA,CAAW,CAAC,GAAG,OAAA,CAAQ,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,QAAA,KAAa,QAAA,CAAS,IAAI,CAAC,CAAA;AAC/E,MAAA,OAAA,CAAQ,KAAA,EAAM;AAAA,IAChB;AAAA,GACF;AAEA,EAAA,eAAe,GAAA,CACb,UAAA,EACA,IAAA,EACA,UAAA,EACe;AACf,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW,QAAA;AAAA,QAC9B,UAAA,CAAW,KAAA;AAAA,QACX,WAAW,OAAA,CAAQ,EAAA;AAAA,QACnB,UAAA,CAAW;AAAA,OACb;AACA,MAAA,IAAA,CAAK,IAAA,CAAK,OAAO,MAAM,CAAA;AACvB,MAAA,IAAA,CAAK,QAAA,CAAS,OAAO,MAAM,CAAA;AAAA,IAC7B,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,UAAA,CAAW,MAAA,CAAO,OAAA,EAAS,IAAA,CAAK,SAAA,EAAU;AAAA,WACzC,IAAA,CAAK,KAAK,KAAK,CAAA;AAAA,IACtB,CAAA,SAAE;AACA,MAAA,OAAA,CAAQ,MAAA,CAAO,WAAW,EAAE,CAAA;AAAA,IAC9B;AAAA,EACF;AACF","file":"intelligence.mjs","sourcesContent":["import {\n type ActivityId,\n type ActivitySink,\n type ActivitySubmission,\n IntelligenceError,\n type IntelligenceProvider,\n} from '@forgeax/engine-intelligence';\nimport { err, ok } from '@forgeax/engine-types';\n\nimport type { DshRealmConnection } from './engine-host';\n\ninterface RunningActivity {\n readonly controller: AbortController;\n readonly sink: ActivitySink;\n readonly task: Promise<void>;\n}\n\n/** Adapt one ready DSH realm bridge to the provider-neutral AI Native Activity contract. */\nexport function createDshRealmIntelligenceProvider(\n connection: DshRealmConnection,\n): IntelligenceProvider {\n const running = new Map<ActivityId, RunningActivity>();\n let closed = false;\n\n return {\n id: 'deepseek-harness-federated',\n start(submission, sink) {\n if (closed) {\n return err(new IntelligenceError({ code: 'intelligence-closed', detail: {} }));\n }\n const controller = new AbortController();\n const task = run(submission, sink, controller);\n running.set(submission.id, { controller, sink, task });\n return ok(undefined);\n },\n cancel(id) {\n const activity = running.get(id);\n if (activity === undefined) {\n return err(\n new IntelligenceError({\n code: 'intelligence-activity-not-found',\n detail: { activityId: id },\n }),\n );\n }\n activity.controller.abort();\n return ok(undefined);\n },\n async close() {\n if (closed) return;\n closed = true;\n for (const activity of running.values()) activity.controller.abort();\n await Promise.allSettled([...running.values()].map((activity) => activity.task));\n running.clear();\n },\n };\n\n async function run(\n submission: ActivitySubmission,\n sink: ActivitySink,\n controller: AbortController,\n ): Promise<void> {\n try {\n const result = await connection.activity(\n submission.input,\n submission.session.id,\n controller.signal,\n );\n sink.text(result.output);\n sink.complete(result.output);\n } catch (error) {\n if (controller.signal.aborted) sink.cancelled();\n else sink.fail(error);\n } finally {\n running.delete(submission.id);\n }\n }\n}\n"]}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
export declare const FEDERATION_PROTOCOL_VERSION: 1;
|
|
2
|
+
export declare const FEDERATION_ROUTE_PREFIX: "/forgeax-federation/v1";
|
|
3
|
+
export type FederationBinding = 'attach' | 'external' | 'embedded';
|
|
4
|
+
export type FederationOwnership = 'lease' | 'instance';
|
|
5
|
+
export interface FederationStatus {
|
|
6
|
+
readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;
|
|
7
|
+
readonly identity: string;
|
|
8
|
+
readonly ready: true;
|
|
9
|
+
readonly realm: 'dsh';
|
|
10
|
+
readonly capabilities: readonly string[];
|
|
11
|
+
readonly leases: number;
|
|
12
|
+
readonly engine: EngineProjection;
|
|
13
|
+
}
|
|
14
|
+
export type EngineProjection = EngineEndpointProjection | EmbeddedEngineProjection;
|
|
15
|
+
export interface EngineEndpointProjection {
|
|
16
|
+
readonly binding: 'external';
|
|
17
|
+
readonly endpoint: string;
|
|
18
|
+
readonly ready: true;
|
|
19
|
+
}
|
|
20
|
+
export interface EmbeddedEngineProjection {
|
|
21
|
+
readonly binding: 'embedded';
|
|
22
|
+
readonly ready: true;
|
|
23
|
+
readonly frameId: number;
|
|
24
|
+
readonly tick: number;
|
|
25
|
+
readonly state: number;
|
|
26
|
+
}
|
|
27
|
+
export interface FederationLease {
|
|
28
|
+
readonly leaseId: string;
|
|
29
|
+
}
|
|
30
|
+
export interface FederationCommunityCapability {
|
|
31
|
+
readonly id: string;
|
|
32
|
+
readonly value: string;
|
|
33
|
+
}
|
|
34
|
+
export interface FederationActivityResult {
|
|
35
|
+
readonly output: string;
|
|
36
|
+
}
|
|
37
|
+
export interface EnginePreviewStatus {
|
|
38
|
+
readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;
|
|
39
|
+
readonly kind: 'forgeax-engine-status';
|
|
40
|
+
readonly binding: 'external';
|
|
41
|
+
readonly ready: true;
|
|
42
|
+
readonly frameId: number;
|
|
43
|
+
readonly tick: number;
|
|
44
|
+
readonly state: number;
|
|
45
|
+
}
|
|
46
|
+
export interface EnginePreviewPoll {
|
|
47
|
+
readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;
|
|
48
|
+
readonly kind: 'forgeax-engine-poll';
|
|
49
|
+
}
|
|
50
|
+
export interface EnginePreviewControl {
|
|
51
|
+
readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;
|
|
52
|
+
readonly kind: 'forgeax-engine-control';
|
|
53
|
+
readonly action: 'toggle';
|
|
54
|
+
}
|
|
55
|
+
export type EnginePreviewRequest = EnginePreviewPoll | EnginePreviewControl;
|
|
56
|
+
export declare function isEnginePreviewRequest(value: unknown): value is EnginePreviewRequest;
|
|
57
|
+
export declare function isEnginePreviewStatus(value: unknown): value is EnginePreviewStatus;
|
|
58
|
+
export declare function isFederationStatus(value: unknown): value is FederationStatus;
|
|
59
|
+
//# sourceMappingURL=protocol.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,uBAAuB,EAAG,wBAAiC,CAAC;AAEzE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAE5E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAMpF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAYlF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAc5E"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
// src/protocol.ts
|
|
2
|
+
var FEDERATION_PROTOCOL_VERSION = 1;
|
|
3
|
+
var FEDERATION_ROUTE_PREFIX = "/forgeax-federation/v1";
|
|
4
|
+
function isEnginePreviewRequest(value) {
|
|
5
|
+
if (typeof value !== "object" || value === null) return false;
|
|
6
|
+
const record = value;
|
|
7
|
+
if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;
|
|
8
|
+
if (record.kind === "forgeax-engine-poll") return true;
|
|
9
|
+
return record.kind === "forgeax-engine-control" && record.action === "toggle";
|
|
10
|
+
}
|
|
11
|
+
function isEnginePreviewStatus(value) {
|
|
12
|
+
if (typeof value !== "object" || value === null) return false;
|
|
13
|
+
const record = value;
|
|
14
|
+
return record.protocol === FEDERATION_PROTOCOL_VERSION && record.kind === "forgeax-engine-status" && record.binding === "external" && record.ready === true && typeof record.frameId === "number" && typeof record.tick === "number" && typeof record.state === "number";
|
|
15
|
+
}
|
|
16
|
+
function isFederationStatus(value) {
|
|
17
|
+
if (typeof value !== "object" || value === null) return false;
|
|
18
|
+
const record = value;
|
|
19
|
+
return record.protocol === FEDERATION_PROTOCOL_VERSION && record.realm === "dsh" && record.ready === true && typeof record.identity === "string" && Array.isArray(record.capabilities) && record.capabilities.every((capability) => typeof capability === "string") && Number.isInteger(record.leases) && record.leases >= 0 && isEngineProjection(record.engine);
|
|
20
|
+
}
|
|
21
|
+
function isEngineProjection(value) {
|
|
22
|
+
if (typeof value !== "object" || value === null) return false;
|
|
23
|
+
const record = value;
|
|
24
|
+
if (record.ready !== true) return false;
|
|
25
|
+
if (record.binding === "external") return typeof record.endpoint === "string";
|
|
26
|
+
return record.binding === "embedded" && typeof record.frameId === "number" && typeof record.tick === "number" && typeof record.state === "number";
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export { FEDERATION_PROTOCOL_VERSION, FEDERATION_ROUTE_PREFIX, isEnginePreviewRequest, isEnginePreviewStatus, isFederationStatus };
|
|
30
|
+
//# sourceMappingURL=protocol.mjs.map
|
|
31
|
+
//# sourceMappingURL=protocol.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";AAAO,IAAM,2BAAA,GAA8B;AACpC,IAAM,uBAAA,GAA0B;AAmEhC,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,MAAM,MAAA,GAAS,KAAA;AACf,EAAA,IAAI,MAAA,CAAO,QAAA,KAAa,2BAAA,EAA6B,OAAO,KAAA;AAC5D,EAAA,IAAI,MAAA,CAAO,IAAA,KAAS,qBAAA,EAAuB,OAAO,IAAA;AAClD,EAAA,OAAO,MAAA,CAAO,IAAA,KAAS,wBAAA,IAA4B,MAAA,CAAO,MAAA,KAAW,QAAA;AACvE;AAEO,SAAS,sBAAsB,KAAA,EAA8C;AAClF,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,MAAM,MAAA,GAAS,KAAA;AACf,EAAA,OACE,MAAA,CAAO,aAAa,2BAAA,IACpB,MAAA,CAAO,SAAS,uBAAA,IAChB,MAAA,CAAO,OAAA,KAAY,UAAA,IACnB,MAAA,CAAO,KAAA,KAAU,QACjB,OAAO,MAAA,CAAO,YAAY,QAAA,IAC1B,OAAO,OAAO,IAAA,KAAS,QAAA,IACvB,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA;AAE5B;AAEO,SAAS,mBAAmB,KAAA,EAA2C;AAC5E,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,MAAM,MAAA,GAAS,KAAA;AACf,EAAA,OACE,OAAO,QAAA,KAAa,2BAAA,IACpB,MAAA,CAAO,KAAA,KAAU,SACjB,MAAA,CAAO,KAAA,KAAU,IAAA,IACjB,OAAO,OAAO,QAAA,KAAa,QAAA,IAC3B,KAAA,CAAM,OAAA,CAAQ,OAAO,YAAY,CAAA,IACjC,MAAA,CAAO,YAAA,CAAa,MAAM,CAAC,UAAA,KAAe,OAAO,UAAA,KAAe,QAAQ,CAAA,IACxE,MAAA,CAAO,SAAA,CAAU,MAAA,CAAO,MAAM,CAAA,IAC7B,MAAA,CAAO,UAAqB,CAAA,IAC7B,kBAAA,CAAmB,OAAO,MAAM,CAAA;AAEpC;AAEA,SAAS,mBAAmB,KAAA,EAA2C;AACrE,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,MAAM,MAAA,GAAS,KAAA;AACf,EAAA,IAAI,MAAA,CAAO,KAAA,KAAU,IAAA,EAAM,OAAO,KAAA;AAClC,EAAA,IAAI,OAAO,OAAA,KAAY,UAAA,EAAY,OAAO,OAAO,OAAO,QAAA,KAAa,QAAA;AACrE,EAAA,OACE,MAAA,CAAO,OAAA,KAAY,UAAA,IACnB,OAAO,MAAA,CAAO,OAAA,KAAY,QAAA,IAC1B,OAAO,MAAA,CAAO,IAAA,KAAS,QAAA,IACvB,OAAO,OAAO,KAAA,KAAU,QAAA;AAE5B","file":"protocol.mjs","sourcesContent":["export const FEDERATION_PROTOCOL_VERSION = 1 as const;\nexport const FEDERATION_ROUTE_PREFIX = '/forgeax-federation/v1' as const;\n\nexport type FederationBinding = 'attach' | 'external' | 'embedded';\nexport type FederationOwnership = 'lease' | 'instance';\n\nexport interface FederationStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly identity: string;\n readonly ready: true;\n readonly realm: 'dsh';\n readonly capabilities: readonly string[];\n readonly leases: number;\n readonly engine: EngineProjection;\n}\n\nexport type EngineProjection = EngineEndpointProjection | EmbeddedEngineProjection;\n\nexport interface EngineEndpointProjection {\n readonly binding: 'external';\n readonly endpoint: string;\n readonly ready: true;\n}\n\nexport interface EmbeddedEngineProjection {\n readonly binding: 'embedded';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface FederationLease {\n readonly leaseId: string;\n}\n\nexport interface FederationCommunityCapability {\n readonly id: string;\n readonly value: string;\n}\n\nexport interface FederationActivityResult {\n readonly output: string;\n}\n\nexport interface EnginePreviewStatus {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-status';\n readonly binding: 'external';\n readonly ready: true;\n readonly frameId: number;\n readonly tick: number;\n readonly state: number;\n}\n\nexport interface EnginePreviewPoll {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-poll';\n}\n\nexport interface EnginePreviewControl {\n readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n readonly kind: 'forgeax-engine-control';\n readonly action: 'toggle';\n}\n\nexport type EnginePreviewRequest = EnginePreviewPoll | EnginePreviewControl;\n\nexport function isEnginePreviewRequest(value: unknown): value is EnginePreviewRequest {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;\n if (record.kind === 'forgeax-engine-poll') return true;\n return record.kind === 'forgeax-engine-control' && record.action === 'toggle';\n}\n\nexport function isEnginePreviewStatus(value: unknown): value is EnginePreviewStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.kind === 'forgeax-engine-status' &&\n record.binding === 'external' &&\n record.ready === true &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n\nexport function isFederationStatus(value: unknown): value is FederationStatus {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n return (\n record.protocol === FEDERATION_PROTOCOL_VERSION &&\n record.realm === 'dsh' &&\n record.ready === true &&\n typeof record.identity === 'string' &&\n Array.isArray(record.capabilities) &&\n record.capabilities.every((capability) => typeof capability === 'string') &&\n Number.isInteger(record.leases) &&\n (record.leases as number) >= 0 &&\n isEngineProjection(record.engine)\n );\n}\n\nfunction isEngineProjection(value: unknown): value is EngineProjection {\n if (typeof value !== 'object' || value === null) return false;\n const record = value as Record<string, unknown>;\n if (record.ready !== true) return false;\n if (record.binding === 'external') return typeof record.endpoint === 'string';\n return (\n record.binding === 'embedded' &&\n typeof record.frameId === 'number' &&\n typeof record.tick === 'number' &&\n typeof record.state === 'number'\n );\n}\n"]}
|