taskflow-mcp-core 0.3.0-beta.1.1 → 1.0.0
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/CONTROL_GUIDE.md +113 -0
- package/README.md +34 -25
- package/dist/control/admission-service.d.ts +15 -0
- package/dist/control/admission-service.d.ts.map +1 -0
- package/dist/control/admission-service.js +64 -0
- package/dist/control/admission-service.js.map +1 -0
- package/dist/control/approval-edits.d.ts +12 -0
- package/dist/control/approval-edits.d.ts.map +1 -0
- package/dist/control/approval-edits.js +66 -0
- package/dist/control/approval-edits.js.map +1 -0
- package/dist/control/approval-service.d.ts +173 -0
- package/dist/control/approval-service.d.ts.map +1 -0
- package/dist/control/approval-service.js +342 -0
- package/dist/control/approval-service.js.map +1 -0
- package/dist/control/authorization.d.ts +94 -0
- package/dist/control/authorization.d.ts.map +1 -0
- package/dist/control/authorization.js +302 -0
- package/dist/control/authorization.js.map +1 -0
- package/dist/control/control-cli.d.ts +3 -0
- package/dist/control/control-cli.d.ts.map +1 -0
- package/dist/control/control-cli.js +279 -0
- package/dist/control/control-cli.js.map +1 -0
- package/dist/control/control-console.d.ts +17 -0
- package/dist/control/control-console.d.ts.map +1 -0
- package/dist/control/control-console.js +67 -0
- package/dist/control/control-console.js.map +1 -0
- package/dist/control/control-host.d.ts +98 -0
- package/dist/control/control-host.d.ts.map +1 -0
- package/dist/control/control-host.js +459 -0
- package/dist/control/control-host.js.map +1 -0
- package/dist/control/control-mcp.d.ts +11 -0
- package/dist/control/control-mcp.d.ts.map +1 -0
- package/dist/control/control-mcp.js +78 -0
- package/dist/control/control-mcp.js.map +1 -0
- package/dist/control/errors.d.ts +44 -0
- package/dist/control/errors.d.ts.map +1 -0
- package/dist/control/errors.js +93 -0
- package/dist/control/errors.js.map +1 -0
- package/dist/control/hello.d.ts +39 -0
- package/dist/control/hello.d.ts.map +1 -0
- package/dist/control/hello.js +80 -0
- package/dist/control/hello.js.map +1 -0
- package/dist/control/host-runtime.d.ts +32 -0
- package/dist/control/host-runtime.d.ts.map +1 -0
- package/dist/control/host-runtime.js +542 -0
- package/dist/control/host-runtime.js.map +1 -0
- package/dist/control/index.d.ts +32 -0
- package/dist/control/index.d.ts.map +1 -0
- package/dist/control/index.js +32 -0
- package/dist/control/index.js.map +1 -0
- package/dist/control/legacy-conflict.d.ts +19 -0
- package/dist/control/legacy-conflict.d.ts.map +1 -0
- package/dist/control/legacy-conflict.js +176 -0
- package/dist/control/legacy-conflict.js.map +1 -0
- package/dist/control/local-bootstrap.d.ts +21 -0
- package/dist/control/local-bootstrap.d.ts.map +1 -0
- package/dist/control/local-bootstrap.js +224 -0
- package/dist/control/local-bootstrap.js.map +1 -0
- package/dist/control/modes.d.ts +60 -0
- package/dist/control/modes.d.ts.map +1 -0
- package/dist/control/modes.js +86 -0
- package/dist/control/modes.js.map +1 -0
- package/dist/control/project-admin-cli.d.ts +3 -0
- package/dist/control/project-admin-cli.d.ts.map +1 -0
- package/dist/control/project-admin-cli.js +155 -0
- package/dist/control/project-admin-cli.js.map +1 -0
- package/dist/control/project-registry.d.ts +20 -0
- package/dist/control/project-registry.d.ts.map +1 -0
- package/dist/control/project-registry.js +181 -0
- package/dist/control/project-registry.js.map +1 -0
- package/dist/control/runtime-checkpoint.d.ts +11 -0
- package/dist/control/runtime-checkpoint.d.ts.map +1 -0
- package/dist/control/runtime-checkpoint.js +39 -0
- package/dist/control/runtime-checkpoint.js.map +1 -0
- package/dist/control/runtime-provider.d.ts +100 -0
- package/dist/control/runtime-provider.d.ts.map +1 -0
- package/dist/control/runtime-provider.js +258 -0
- package/dist/control/runtime-provider.js.map +1 -0
- package/dist/control/schema/approval.d.ts +108 -0
- package/dist/control/schema/approval.d.ts.map +1 -0
- package/dist/control/schema/approval.js +65 -0
- package/dist/control/schema/approval.js.map +1 -0
- package/dist/control/schema/commands.d.ts +663 -0
- package/dist/control/schema/commands.d.ts.map +1 -0
- package/dist/control/schema/commands.js +147 -0
- package/dist/control/schema/commands.js.map +1 -0
- package/dist/control/schema/common.d.ts +24 -0
- package/dist/control/schema/common.d.ts.map +1 -0
- package/dist/control/schema/common.js +38 -0
- package/dist/control/schema/common.js.map +1 -0
- package/dist/control/schema/coordinator.d.ts +98 -0
- package/dist/control/schema/coordinator.d.ts.map +1 -0
- package/dist/control/schema/coordinator.js +87 -0
- package/dist/control/schema/coordinator.js.map +1 -0
- package/dist/control/schema/evidence.d.ts +140 -0
- package/dist/control/schema/evidence.d.ts.map +1 -0
- package/dist/control/schema/evidence.js +64 -0
- package/dist/control/schema/evidence.js.map +1 -0
- package/dist/control/schema/header.d.ts +79 -0
- package/dist/control/schema/header.d.ts.map +1 -0
- package/dist/control/schema/header.js +66 -0
- package/dist/control/schema/header.js.map +1 -0
- package/dist/control/schema/index.d.ts +31 -0
- package/dist/control/schema/index.d.ts.map +1 -0
- package/dist/control/schema/index.js +31 -0
- package/dist/control/schema/index.js.map +1 -0
- package/dist/control/schema/plan.d.ts +291 -0
- package/dist/control/schema/plan.d.ts.map +1 -0
- package/dist/control/schema/plan.js +80 -0
- package/dist/control/schema/plan.js.map +1 -0
- package/dist/control/schema/policy.d.ts +96 -0
- package/dist/control/schema/policy.d.ts.map +1 -0
- package/dist/control/schema/policy.js +73 -0
- package/dist/control/schema/policy.js.map +1 -0
- package/dist/control/schema/run.d.ts +61 -0
- package/dist/control/schema/run.d.ts.map +1 -0
- package/dist/control/schema/run.js +56 -0
- package/dist/control/schema/run.js.map +1 -0
- package/dist/control/schema/te-mirrors.d.ts +145 -0
- package/dist/control/schema/te-mirrors.d.ts.map +1 -0
- package/dist/control/schema/te-mirrors.js +145 -0
- package/dist/control/schema/te-mirrors.js.map +1 -0
- package/dist/control/schema/transport.d.ts +479 -0
- package/dist/control/schema/transport.d.ts.map +1 -0
- package/dist/control/schema/transport.js +181 -0
- package/dist/control/schema/transport.js.map +1 -0
- package/dist/control/singleton.d.ts +135 -0
- package/dist/control/singleton.d.ts.map +1 -0
- package/dist/control/singleton.js +607 -0
- package/dist/control/singleton.js.map +1 -0
- package/dist/control/store/coordinator-store.d.ts +143 -0
- package/dist/control/store/coordinator-store.d.ts.map +1 -0
- package/dist/control/store/coordinator-store.js +620 -0
- package/dist/control/store/coordinator-store.js.map +1 -0
- package/dist/control/store/evidence-adapter.d.ts +10 -0
- package/dist/control/store/evidence-adapter.d.ts.map +1 -0
- package/dist/control/store/evidence-adapter.js +114 -0
- package/dist/control/store/evidence-adapter.js.map +1 -0
- package/dist/control/store/evidence-explanation.d.ts +55 -0
- package/dist/control/store/evidence-explanation.d.ts.map +1 -0
- package/dist/control/store/evidence-explanation.js +50 -0
- package/dist/control/store/evidence-explanation.js.map +1 -0
- package/dist/control/store/evidence-store.d.ts +143 -0
- package/dist/control/store/evidence-store.d.ts.map +1 -0
- package/dist/control/store/evidence-store.js +437 -0
- package/dist/control/store/evidence-store.js.map +1 -0
- package/dist/control/store/index.d.ts +3 -0
- package/dist/control/store/index.d.ts.map +1 -0
- package/dist/control/store/index.js +2 -0
- package/dist/control/store/index.js.map +1 -0
- package/dist/control/store/journal.d.ts +270 -0
- package/dist/control/store/journal.d.ts.map +1 -0
- package/dist/control/store/journal.js +50 -0
- package/dist/control/store/journal.js.map +1 -0
- package/dist/control/store/project-lifecycle.d.ts +49 -0
- package/dist/control/store/project-lifecycle.d.ts.map +1 -0
- package/dist/control/store/project-lifecycle.js +288 -0
- package/dist/control/store/project-lifecycle.js.map +1 -0
- package/dist/control/store/store.d.ts +93 -0
- package/dist/control/store/store.d.ts.map +1 -0
- package/dist/control/store/store.js +873 -0
- package/dist/control/store/store.js.map +1 -0
- package/dist/control/te-provider.d.ts +86 -0
- package/dist/control/te-provider.d.ts.map +1 -0
- package/dist/control/te-provider.js +131 -0
- package/dist/control/te-provider.js.map +1 -0
- package/dist/control/uds.d.ts +114 -0
- package/dist/control/uds.d.ts.map +1 -0
- package/dist/control/uds.js +456 -0
- package/dist/control/uds.js.map +1 -0
- package/dist/control/web-console/view.d.ts +5 -0
- package/dist/control/web-console/view.d.ts.map +1 -0
- package/dist/control/web-console/view.js +122 -0
- package/dist/control/web-console/view.js.map +1 -0
- package/dist/control/web-console.d.ts +50 -0
- package/dist/control/web-console.d.ts.map +1 -0
- package/dist/control/web-console.js +317 -0
- package/dist/control/web-console.js.map +1 -0
- package/dist/mcp/jsonrpc.d.ts.map +1 -1
- package/dist/mcp/jsonrpc.js +12 -3
- package/dist/mcp/jsonrpc.js.map +1 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +26 -17
- package/dist/mcp/server.js.map +1 -1
- package/package.json +13 -5
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../taskflow-control/src/schema/transport.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* User singleton lock + coordination endpoint + fencing (P13 / RFC §5.1 D32).
|
|
3
|
+
*
|
|
4
|
+
* Contract implemented here (P13 "排他锁语义" + fresh-install §5.2):
|
|
5
|
+
* - Owner publishes via hard-link create — never rename-overwrite.
|
|
6
|
+
* - Malformed singleton metadata fails closed.
|
|
7
|
+
* - Dead-PID takeover stays fail-closed: reclaim only when the owner is
|
|
8
|
+
* provably dead (liveness probe) AND the record's birth token still matches
|
|
9
|
+
* (PID reuse cannot inherit a live holder's lock).
|
|
10
|
+
* - Collaborative competitors use identity-bound reclaim: fixed claim file +
|
|
11
|
+
* O_EXCL + generation check + rename-to-discard + recoverable claim cleanup.
|
|
12
|
+
* - Release = compare-and-delete on acquire-time device/inode + owner token
|
|
13
|
+
* (rename-to-discard).
|
|
14
|
+
* - Stale endpoint recovery: dead peer ⇒ remove socket file ⇒ restart.
|
|
15
|
+
* - Fencing: every acquire/reclaim bumps the CoordinatorLease epoch; RPCs
|
|
16
|
+
* carrying an older epoch are rejected (TF_AUTHORITY_REVOKED).
|
|
17
|
+
*
|
|
18
|
+
* TE's `resources/*` persistence helpers are deliberately not exported by
|
|
19
|
+
* taskflow-core, so this module re-implements the small POSIX primitives
|
|
20
|
+
* (atomic write, process birth token) with the same fail-closed discipline.
|
|
21
|
+
*/
|
|
22
|
+
import { type CoordinatorLease } from "./schema/coordinator.ts";
|
|
23
|
+
export declare const TASKFLOW_HOME_ENV = "TASKFLOW_HOME";
|
|
24
|
+
export declare const DEFAULT_CONTROL_DIR_NAME = "control";
|
|
25
|
+
export declare function userTaskflowHome(homeOverride?: string): string;
|
|
26
|
+
export declare function userControlHome(homeOverride?: string): string;
|
|
27
|
+
export interface SingletonPaths {
|
|
28
|
+
controlHome: string;
|
|
29
|
+
/** Hard-link-created owner record (never rename-overwrite). */
|
|
30
|
+
lockPath: string;
|
|
31
|
+
/** Coordination endpoint (Unix UDS path / pipe name). */
|
|
32
|
+
endpointPath: string;
|
|
33
|
+
/** Renewable CoordinatorLease record (P16 wire type). */
|
|
34
|
+
leasePath: string;
|
|
35
|
+
}
|
|
36
|
+
export declare function singletonPaths(controlHome?: string): SingletonPaths;
|
|
37
|
+
export type BirthTokenKind = "native" | "opaque";
|
|
38
|
+
export interface ProcessIdentityLike {
|
|
39
|
+
pid: number;
|
|
40
|
+
birthToken: string;
|
|
41
|
+
birthTokenKind: BirthTokenKind;
|
|
42
|
+
}
|
|
43
|
+
export interface ObservedProcessLike {
|
|
44
|
+
alive: boolean;
|
|
45
|
+
birthToken?: string;
|
|
46
|
+
birthTokenKind?: BirthTokenKind;
|
|
47
|
+
}
|
|
48
|
+
/** Exact, platform-native process-birth identity; never an uptime estimate. */
|
|
49
|
+
export declare function readProcessBirthToken(pid: number): string | undefined;
|
|
50
|
+
export declare function defaultProcessIdentity(): ProcessIdentityLike;
|
|
51
|
+
export declare function defaultProcessInspector(pid: number): ObservedProcessLike;
|
|
52
|
+
export declare const SINGLETON_LOCK_VERSION = 1;
|
|
53
|
+
export interface SingletonLockRecord {
|
|
54
|
+
version: typeof SINGLETON_LOCK_VERSION;
|
|
55
|
+
holderId: string;
|
|
56
|
+
pid: number;
|
|
57
|
+
birthToken: string;
|
|
58
|
+
birthTokenKind: BirthTokenKind;
|
|
59
|
+
fencingEpoch: number;
|
|
60
|
+
endpoint: string;
|
|
61
|
+
acquiredAt: number;
|
|
62
|
+
}
|
|
63
|
+
export interface ClaimRecord {
|
|
64
|
+
version: 1;
|
|
65
|
+
claimantId: string;
|
|
66
|
+
pid: number;
|
|
67
|
+
birthToken: string;
|
|
68
|
+
birthTokenKind: BirthTokenKind;
|
|
69
|
+
createdAt: number;
|
|
70
|
+
/** Generation (acquiredAt) of the lock record the claimant observed. */
|
|
71
|
+
targetGeneration: number;
|
|
72
|
+
}
|
|
73
|
+
export declare function writeJsonAtomicDurable(filePath: string, value: unknown): void;
|
|
74
|
+
export interface SingletonOptions {
|
|
75
|
+
paths: SingletonPaths;
|
|
76
|
+
holderId?: string;
|
|
77
|
+
processIdentity?: ProcessIdentityLike;
|
|
78
|
+
inspectProcess?: (pid: number) => ObservedProcessLike;
|
|
79
|
+
now?: () => number;
|
|
80
|
+
/** Hard pass budget (P13: maxAttempts is a pass budget, not spins×K). */
|
|
81
|
+
maxAttempts?: number;
|
|
82
|
+
/** Renewal TTL for the CoordinatorLease (default 30s; renew while held). */
|
|
83
|
+
leaseTtlMs?: number;
|
|
84
|
+
/**
|
|
85
|
+
* coordinated mode (P13): attach to an existing winner only. No lock
|
|
86
|
+
* publication and no reclaim — a missing/dead control fails closed with
|
|
87
|
+
* TF_JOURNAL_UNAVAILABLE instead of being started.
|
|
88
|
+
*/
|
|
89
|
+
attachOnly?: boolean;
|
|
90
|
+
}
|
|
91
|
+
export type SingletonAcquireResult = {
|
|
92
|
+
status: "won";
|
|
93
|
+
holderId: string;
|
|
94
|
+
fencingEpoch: number;
|
|
95
|
+
endpoint: string;
|
|
96
|
+
/** Compare-and-delete release (rename-to-discard). */
|
|
97
|
+
release: () => void;
|
|
98
|
+
} | {
|
|
99
|
+
status: "attached";
|
|
100
|
+
/** Winner's identity — this process attaches as a client (D32). */
|
|
101
|
+
holderId: string;
|
|
102
|
+
fencingEpoch: number;
|
|
103
|
+
endpoint: string;
|
|
104
|
+
};
|
|
105
|
+
export declare function acquireUserSingleton(options: SingletonOptions): SingletonAcquireResult;
|
|
106
|
+
export interface SingletonReleaseIdentity {
|
|
107
|
+
holderId: string;
|
|
108
|
+
dev: bigint;
|
|
109
|
+
ino: bigint;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Release = compare-and-delete on acquire-time device/inode + owner token
|
|
113
|
+
* (P13). rename-to-discard keeps the unlink atomic.
|
|
114
|
+
*/
|
|
115
|
+
export declare function releaseUserSingleton(paths: SingletonPaths, acquired: SingletonReleaseIdentity): void;
|
|
116
|
+
export interface StaleEndpointOptions {
|
|
117
|
+
inspectProcess?: (pid: number) => ObservedProcessLike;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Fresh-install contract §5.2(4): detect a dead peer (pid/lock), remove its
|
|
121
|
+
* socket file, and let the next acquire restart cleanly. A live owner's
|
|
122
|
+
* endpoint is never touched; malformed metadata fails closed.
|
|
123
|
+
*/
|
|
124
|
+
export declare function recoverStaleEndpoint(paths: SingletonPaths, options?: StaleEndpointOptions): boolean;
|
|
125
|
+
/**
|
|
126
|
+
* Fencing: a client RPC must present a fencingEpoch >= the current lease
|
|
127
|
+
* epoch, or the holder has been fenced out (stale writer) → TF_AUTHORITY_REVOKED.
|
|
128
|
+
* A missing lease means no verifiable authority exists — fail closed rather
|
|
129
|
+
* than accept an unverifiable claim.
|
|
130
|
+
*/
|
|
131
|
+
export declare function assertFencing(lease: CoordinatorLease | null, claimedEpoch: number): void;
|
|
132
|
+
/** Read the current CoordinatorLease record (null when none exists). */
|
|
133
|
+
export declare function readCoordinatorLease(paths: SingletonPaths): CoordinatorLease | null;
|
|
134
|
+
export declare function renewCoordinatorLease(paths: SingletonPaths, holderId: string, epoch: number, ttlMs: number, now?: () => number): CoordinatorLease;
|
|
135
|
+
//# sourceMappingURL=singleton.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../taskflow-control/src/singleton.ts"],"names":[],"mappings":"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"}
|