@compozy/extension-sdk 0.3.0-beta.3

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.
Files changed (142) hide show
  1. package/LICENSE +21 -0
  2. package/dist/cjs/base-types.js +3 -0
  3. package/dist/cjs/base-types.js.map +1 -0
  4. package/dist/cjs/capabilities.js +27 -0
  5. package/dist/cjs/capabilities.js.map +1 -0
  6. package/dist/cjs/errors.js +123 -0
  7. package/dist/cjs/errors.js.map +1 -0
  8. package/dist/cjs/extension-context.js +28 -0
  9. package/dist/cjs/extension-context.js.map +1 -0
  10. package/dist/cjs/extension-contract.js +8 -0
  11. package/dist/cjs/extension-contract.js.map +1 -0
  12. package/dist/cjs/extension-describe.js +72 -0
  13. package/dist/cjs/extension-describe.js.map +1 -0
  14. package/dist/cjs/extension-initialize.js +67 -0
  15. package/dist/cjs/extension-initialize.js.map +1 -0
  16. package/dist/cjs/extension-runtime.js +227 -0
  17. package/dist/cjs/extension-runtime.js.map +1 -0
  18. package/dist/cjs/extension-tool-context.js +29 -0
  19. package/dist/cjs/extension-tool-context.js.map +1 -0
  20. package/dist/cjs/extension-tool-registration.js +42 -0
  21. package/dist/cjs/extension-tool-registration.js.map +1 -0
  22. package/dist/cjs/extension.js +329 -0
  23. package/dist/cjs/extension.js.map +1 -0
  24. package/dist/cjs/generated/contracts.js +20 -0
  25. package/dist/cjs/generated/contracts.js.map +1 -0
  26. package/dist/cjs/host-api.js +187 -0
  27. package/dist/cjs/host-api.js.map +1 -0
  28. package/dist/cjs/index.js +31 -0
  29. package/dist/cjs/index.js.map +1 -0
  30. package/dist/cjs/json.js +13 -0
  31. package/dist/cjs/json.js.map +1 -0
  32. package/dist/cjs/package.json +3 -0
  33. package/dist/cjs/schema-digest.js +45 -0
  34. package/dist/cjs/schema-digest.js.map +1 -0
  35. package/dist/cjs/testing/conformance.js +23 -0
  36. package/dist/cjs/testing/conformance.js.map +1 -0
  37. package/dist/cjs/testing/harness.js +158 -0
  38. package/dist/cjs/testing/harness.js.map +1 -0
  39. package/dist/cjs/testing/index.js +12 -0
  40. package/dist/cjs/testing/index.js.map +1 -0
  41. package/dist/cjs/testing/mock-transport.js +74 -0
  42. package/dist/cjs/testing/mock-transport.js.map +1 -0
  43. package/dist/cjs/transport.js +240 -0
  44. package/dist/cjs/transport.js.map +1 -0
  45. package/dist/cjs/types.js +19 -0
  46. package/dist/cjs/types.js.map +1 -0
  47. package/dist/cjs/watch-source.js +129 -0
  48. package/dist/cjs/watch-source.js.map +1 -0
  49. package/dist/esm/base-types.js +2 -0
  50. package/dist/esm/base-types.js.map +1 -0
  51. package/dist/esm/capabilities.js +22 -0
  52. package/dist/esm/capabilities.js.map +1 -0
  53. package/dist/esm/errors.js +106 -0
  54. package/dist/esm/errors.js.map +1 -0
  55. package/dist/esm/extension-context.js +24 -0
  56. package/dist/esm/extension-context.js.map +1 -0
  57. package/dist/esm/extension-contract.js +6 -0
  58. package/dist/esm/extension-contract.js.map +1 -0
  59. package/dist/esm/extension-describe.js +66 -0
  60. package/dist/esm/extension-describe.js.map +1 -0
  61. package/dist/esm/extension-initialize.js +63 -0
  62. package/dist/esm/extension-initialize.js.map +1 -0
  63. package/dist/esm/extension-runtime.js +214 -0
  64. package/dist/esm/extension-runtime.js.map +1 -0
  65. package/dist/esm/extension-tool-context.js +26 -0
  66. package/dist/esm/extension-tool-context.js.map +1 -0
  67. package/dist/esm/extension-tool-registration.js +39 -0
  68. package/dist/esm/extension-tool-registration.js.map +1 -0
  69. package/dist/esm/extension.js +325 -0
  70. package/dist/esm/extension.js.map +1 -0
  71. package/dist/esm/generated/contracts.js +17 -0
  72. package/dist/esm/generated/contracts.js.map +1 -0
  73. package/dist/esm/host-api.js +183 -0
  74. package/dist/esm/host-api.js.map +1 -0
  75. package/dist/esm/index.js +6 -0
  76. package/dist/esm/index.js.map +1 -0
  77. package/dist/esm/json.js +10 -0
  78. package/dist/esm/json.js.map +1 -0
  79. package/dist/esm/package.json +3 -0
  80. package/dist/esm/schema-digest.js +41 -0
  81. package/dist/esm/schema-digest.js.map +1 -0
  82. package/dist/esm/testing/conformance.js +19 -0
  83. package/dist/esm/testing/conformance.js.map +1 -0
  84. package/dist/esm/testing/harness.js +151 -0
  85. package/dist/esm/testing/harness.js.map +1 -0
  86. package/dist/esm/testing/index.js +4 -0
  87. package/dist/esm/testing/index.js.map +1 -0
  88. package/dist/esm/testing/mock-transport.js +69 -0
  89. package/dist/esm/testing/mock-transport.js.map +1 -0
  90. package/dist/esm/transport.js +235 -0
  91. package/dist/esm/transport.js.map +1 -0
  92. package/dist/esm/types.js +3 -0
  93. package/dist/esm/types.js.map +1 -0
  94. package/dist/esm/watch-source.js +122 -0
  95. package/dist/esm/watch-source.js.map +1 -0
  96. package/dist/types/base-types.d.ts +25 -0
  97. package/dist/types/base-types.d.ts.map +1 -0
  98. package/dist/types/capabilities.d.ts +6 -0
  99. package/dist/types/capabilities.d.ts.map +1 -0
  100. package/dist/types/errors.d.ts +66 -0
  101. package/dist/types/errors.d.ts.map +1 -0
  102. package/dist/types/extension-context.d.ts +6 -0
  103. package/dist/types/extension-context.d.ts.map +1 -0
  104. package/dist/types/extension-contract.d.ts +65 -0
  105. package/dist/types/extension-contract.d.ts.map +1 -0
  106. package/dist/types/extension-describe.d.ts +16 -0
  107. package/dist/types/extension-describe.d.ts.map +1 -0
  108. package/dist/types/extension-initialize.d.ts +4 -0
  109. package/dist/types/extension-initialize.d.ts.map +1 -0
  110. package/dist/types/extension-runtime.d.ts +14 -0
  111. package/dist/types/extension-runtime.d.ts.map +1 -0
  112. package/dist/types/extension-tool-context.d.ts +4 -0
  113. package/dist/types/extension-tool-context.d.ts.map +1 -0
  114. package/dist/types/extension-tool-registration.d.ts +3 -0
  115. package/dist/types/extension-tool-registration.d.ts.map +1 -0
  116. package/dist/types/extension.d.ts +55 -0
  117. package/dist/types/extension.d.ts.map +1 -0
  118. package/dist/types/generated/contracts.d.ts +6173 -0
  119. package/dist/types/generated/contracts.d.ts.map +1 -0
  120. package/dist/types/host-api.d.ts +90 -0
  121. package/dist/types/host-api.d.ts.map +1 -0
  122. package/dist/types/index.d.ts +12 -0
  123. package/dist/types/index.d.ts.map +1 -0
  124. package/dist/types/json.d.ts +3 -0
  125. package/dist/types/json.d.ts.map +1 -0
  126. package/dist/types/schema-digest.d.ts +4 -0
  127. package/dist/types/schema-digest.d.ts.map +1 -0
  128. package/dist/types/testing/conformance.d.ts +7 -0
  129. package/dist/types/testing/conformance.d.ts.map +1 -0
  130. package/dist/types/testing/harness.d.ts +51 -0
  131. package/dist/types/testing/harness.d.ts.map +1 -0
  132. package/dist/types/testing/index.d.ts +4 -0
  133. package/dist/types/testing/index.d.ts.map +1 -0
  134. package/dist/types/testing/mock-transport.d.ts +28 -0
  135. package/dist/types/testing/mock-transport.d.ts.map +1 -0
  136. package/dist/types/transport.d.ts +55 -0
  137. package/dist/types/transport.d.ts.map +1 -0
  138. package/dist/types/types.d.ts +114 -0
  139. package/dist/types/types.d.ts.map +1 -0
  140. package/dist/types/watch-source.d.ts +57 -0
  141. package/dist/types/watch-source.d.ts.map +1 -0
  142. package/package.json +49 -0
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.makeExtensionToolContext = makeExtensionToolContext;
4
+ const errors_js_1 = require("./errors.js");
5
+ function makeExtensionToolContext(call, context) {
6
+ const invocationId = call.invocation_id;
7
+ return {
8
+ input: call.input,
9
+ context,
10
+ host: context.host,
11
+ session: context.session,
12
+ toolID: call.tool_id,
13
+ handler: call.handler,
14
+ ...(call.trusted_workspace !== undefined ? { trustedWorkspace: call.trusted_workspace } : {}),
15
+ ...(invocationId !== undefined ? { invocationId } : {}),
16
+ askClarification: async (question) => {
17
+ if (invocationId === undefined || invocationId.trim() === "") {
18
+ throw new errors_js_1.InvalidParamsError("tool invocation context is required");
19
+ }
20
+ const params = {
21
+ invocation_id: invocationId,
22
+ question: question.question,
23
+ ...(question.choices === undefined ? {} : { choices: [...question.choices] }),
24
+ };
25
+ return await context.host.request("clarify/ask", params);
26
+ },
27
+ };
28
+ }
29
+ //# sourceMappingURL=extension-tool-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension-tool-context.js","sourceRoot":"","sources":["../../src/extension-tool-context.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AAIjD,kCACE,IAA8B,EAC9B,OAAwC;IAExC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;IACxC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAe;QAC3B,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,gBAAgB,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;YACjC,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC7D,MAAM,IAAI,8BAAkB,CAAC,qCAAqC,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,MAAM,GAAqB;gBAC/B,aAAa,EAAE,YAAY;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;aAC9E,CAAC;YACF,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,42 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.buildRegisteredTool = buildRegisteredTool;
4
+ const extension_runtime_js_1 = require("./extension-runtime.js");
5
+ const schema_digest_js_1 = require("./schema-digest.js");
6
+ function buildRegisteredTool(extensionName, handler, options, toolHandler) {
7
+ const inputSchema = (0, extension_runtime_js_1.normalizeSchema)(options.inputSchema, "inputSchema");
8
+ const outputSchema = options.outputSchema === undefined
9
+ ? undefined
10
+ : (0, extension_runtime_js_1.normalizeSchema)(options.outputSchema, "outputSchema");
11
+ const descriptor = {
12
+ id: options.id ?? (0, extension_runtime_js_1.canonicalExtensionToolID)(extensionName, handler),
13
+ handler,
14
+ ...(options.description?.trim() ? { description: options.description.trim() } : {}),
15
+ ...(options.friendlyVerb?.trim() ? { friendly_verb: options.friendlyVerb.trim() } : {}),
16
+ ...(options.preview?.trim() ? { preview: options.preview.trim() } : {}),
17
+ input_schema: inputSchema,
18
+ ...(outputSchema ? { output_schema: outputSchema } : {}),
19
+ input_schema_digest: (0, schema_digest_js_1.schemaDigest)(inputSchema),
20
+ ...(outputSchema ? { output_schema_digest: (0, schema_digest_js_1.schemaDigest)(outputSchema) } : {}),
21
+ read_only: Boolean(options.readOnly),
22
+ risk: options.risk ?? (options.readOnly ? "read" : "mutating"),
23
+ requires_interaction: Boolean(options.requiresInteraction),
24
+ capabilities: (0, extension_runtime_js_1.normalizeStringList)(options.capabilities),
25
+ ...(options.command
26
+ ? {
27
+ command: {
28
+ verb: options.command.verb.trim(),
29
+ summary: options.command.summary.trim(),
30
+ ...(options.command.example?.trim() ? { example: options.command.example.trim() } : {}),
31
+ flags: { ...options.command.flags },
32
+ },
33
+ }
34
+ : {}),
35
+ };
36
+ return {
37
+ descriptor,
38
+ handler: toolHandler,
39
+ sensitiveInputFields: (0, extension_runtime_js_1.normalizeStringList)(options.sensitiveInputFields),
40
+ };
41
+ }
42
+ //# sourceMappingURL=extension-tool-registration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension-tool-registration.js","sourceRoot":"","sources":["../../src/extension-tool-registration.ts"],"names":[],"mappings":";;;AAKA,iEAIgC;AAChC,yDAAkD;AAGlD,6BACE,aAAqB,EACrB,OAAe,EACf,OAA6B,EAC7B,WAAyC;IAEzC,MAAM,WAAW,GAAG,IAAA,sCAAe,EAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACxE,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAA,sCAAe,EAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAmC;QACjD,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAA,+CAAwB,EAAC,aAAa,EAAE,OAAO,CAAC;QAClE,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,YAAY,EAAE,WAAW;QACzB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,mBAAmB,EAAE,IAAA,+BAAY,EAAC,WAAW,CAAC;QAC9C,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAA,+BAAY,EAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;QAC9D,oBAAoB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;QAC1D,YAAY,EAAE,IAAA,0CAAmB,EAAC,OAAO,CAAC,YAAY,CAAC;QACvD,GAAG,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;oBACjC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;oBACvC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvF,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE;iBACpC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,OAAO;QACL,UAAU;QACV,OAAO,EAAE,WAAmC;QAC5C,oBAAoB,EAAE,IAAA,0CAAmB,EAAC,OAAO,CAAC,oBAAoB,CAAC;KACxE,CAAC;AACJ,CAAC"}
@@ -0,0 +1,329 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Extension = void 0;
4
+ const watch_source_js_1 = require("./watch-source.js");
5
+ const host_api_js_1 = require("./host-api.js");
6
+ const transport_js_1 = require("./transport.js");
7
+ const capabilities_js_1 = require("./capabilities.js");
8
+ const errors_js_1 = require("./errors.js");
9
+ const extension_runtime_js_1 = require("./extension-runtime.js");
10
+ const extension_contract_js_1 = require("./extension-contract.js");
11
+ const extension_context_js_1 = require("./extension-context.js");
12
+ const extension_tool_context_js_1 = require("./extension-tool-context.js");
13
+ const extension_initialize_js_1 = require("./extension-initialize.js");
14
+ const extension_describe_js_1 = require("./extension-describe.js");
15
+ const extension_tool_registration_js_1 = require("./extension-tool-registration.js");
16
+ class Extension {
17
+ definition;
18
+ transport;
19
+ stderr;
20
+ sdkVersion;
21
+ describeProcess;
22
+ handlers = new Map();
23
+ toolHandlers = new Map();
24
+ commandGroups = [];
25
+ watchSources = new watch_source_js_1.ExtensionWatchSources({
26
+ bindMethod: method => this.bindMethod(method),
27
+ hasUserHandler: method => this.handlers.has(method),
28
+ makeContext: request => this.makeContext(request),
29
+ });
30
+ readyCallbacks = new Set();
31
+ transportBindings = new Set();
32
+ host;
33
+ initialized = false;
34
+ shutdownStarted = false;
35
+ shutdownDeadlineMS;
36
+ session;
37
+ startPromise;
38
+ resolveStart;
39
+ rejectStart;
40
+ constructor(definition, options = {}) {
41
+ this.definition = definition;
42
+ this.transport = options.transport ?? new transport_js_1.StdioTransport();
43
+ this.stderr = options.stderr ?? process.stderr;
44
+ this.sdkVersion = options.sdkVersion ?? extension_contract_js_1.SDK_VERSION;
45
+ this.describeProcess = options.describeProcess ?? (0, extension_describe_js_1.defaultExtensionDescribeProcess)();
46
+ this.host = new host_api_js_1.HostAPI({
47
+ call: async (method, params) => await this.transport.call(method, params),
48
+ }, { isReady: () => this.initialized && !this.shutdownStarted });
49
+ this.bindTransportHandlers();
50
+ }
51
+ bindTransport(transport) {
52
+ if (this.startPromise) {
53
+ throw new Error("transport may only be swapped before start()");
54
+ }
55
+ this.transport = transport;
56
+ this.transportBindings.clear();
57
+ this.bindTransportHandlers();
58
+ return this;
59
+ }
60
+ handle(method, handler) {
61
+ const cleanMethod = method.trim();
62
+ if (cleanMethod === "initialize") {
63
+ throw new Error("initialize is reserved by the SDK");
64
+ }
65
+ if (this.toolHandlers.size > 0 && (0, capabilities_js_1.isToolProviderMethod)(cleanMethod)) {
66
+ throw new Error(`${cleanMethod} is reserved by extension.tool()`);
67
+ }
68
+ if (this.watchSources.hasHandlers() && (0, watch_source_js_1.isWatchSourceMethod)(cleanMethod)) {
69
+ throw new Error(`${cleanMethod} is reserved by extension.watchSource()`);
70
+ }
71
+ this.handlers.set(cleanMethod, handler);
72
+ this.bindMethod(cleanMethod);
73
+ return this;
74
+ }
75
+ tool(handler, options, toolHandler) {
76
+ const cleanHandler = handler.trim();
77
+ if (!cleanHandler) {
78
+ throw new Error("tool handler is required");
79
+ }
80
+ if (this.toolHandlers.has(cleanHandler)) {
81
+ throw new Error(`tool handler already registered: ${cleanHandler}`);
82
+ }
83
+ if (this.handlers.has(capabilities_js_1.PROVIDE_TOOLS_METHOD) || this.handlers.has(capabilities_js_1.TOOLS_CALL_METHOD)) {
84
+ throw new Error("provide_tools and tools/call are reserved by extension.tool()");
85
+ }
86
+ this.toolHandlers.set(cleanHandler, (0, extension_tool_registration_js_1.buildRegisteredTool)(this.definition.name, cleanHandler, options, toolHandler));
87
+ this.ensureToolProviderCapability();
88
+ this.ensureToolProviderHandlers();
89
+ return this;
90
+ }
91
+ watchSource(kind, options, handler) {
92
+ this.watchSources.register(this.definition, kind, options, handler);
93
+ return this;
94
+ }
95
+ commandGroup(path, summary) {
96
+ if (this.initialized) {
97
+ throw new Error("extension registration is closed after initialize");
98
+ }
99
+ this.commandGroups.push({ path: path.trim(), summary: summary.trim() });
100
+ return this;
101
+ }
102
+ onReady(callback) {
103
+ this.readyCallbacks.add(callback);
104
+ if (this.initialized && this.session) {
105
+ queueMicrotask(() => {
106
+ void this.runReadyCallback(callback, this.session);
107
+ });
108
+ }
109
+ return this;
110
+ }
111
+ async start() {
112
+ if ((0, extension_describe_js_1.runExtensionDescribeMode)(this.describeProcess, () => this.describe())) {
113
+ return this.host;
114
+ }
115
+ if (this.startPromise) {
116
+ return await this.startPromise;
117
+ }
118
+ this.startPromise = new Promise((resolve, reject) => {
119
+ this.resolveStart = resolve;
120
+ this.rejectStart = reject;
121
+ });
122
+ this.transport.onTransportError(error => {
123
+ if (!this.initialized && this.rejectStart) {
124
+ this.rejectStart(error);
125
+ }
126
+ this.logError("transport error", error);
127
+ });
128
+ this.transport.start();
129
+ return await this.startPromise;
130
+ }
131
+ getImplementedMethods() {
132
+ return (0, extension_runtime_js_1.implementedExtensionMethods)(this.handlers.keys(), this.toolHandlers.size > 0, this.watchSources.implementedMethods());
133
+ }
134
+ getSupportedHookEvents() {
135
+ return [...(this.definition.supported_hook_events ?? [])];
136
+ }
137
+ getToolDescriptors() {
138
+ return (0, extension_describe_js_1.cloneExtensionToolDescriptors)(this.toolHandlers.values());
139
+ }
140
+ describe() {
141
+ return (0, extension_describe_js_1.buildExtensionDescribePayload)({
142
+ definition: this.definition,
143
+ tools: this.getToolDescriptors(),
144
+ commandGroups: this.commandGroups.map(group => ({ ...group })),
145
+ watchSourceKinds: this.watchSources.kinds(),
146
+ sdkVersion: this.sdkVersion,
147
+ });
148
+ }
149
+ bindTransportHandlers() {
150
+ for (const method of (0, extension_runtime_js_1.transportMethods)(this.handlers.keys(), this.toolHandlers.size > 0)) {
151
+ this.bindMethod(method);
152
+ }
153
+ this.watchSources.bindMethods();
154
+ }
155
+ bindMethod(method) {
156
+ if (this.transportBindings.has(method)) {
157
+ this.transport.handle(method, async (params, request) => await this.dispatch(method, params, request));
158
+ return;
159
+ }
160
+ this.transportBindings.add(method);
161
+ this.transport.handle(method, async (params, request) => await this.dispatch(method, params, request));
162
+ }
163
+ async dispatch(method, params, request) {
164
+ if (method === "initialize") {
165
+ return await this.handleInitialize(params);
166
+ }
167
+ if (!this.initialized || !this.session) {
168
+ throw new errors_js_1.NotInitializedError();
169
+ }
170
+ if (this.shutdownStarted && method !== "shutdown") {
171
+ throw new errors_js_1.ShutdownInProgressError(this.shutdownDeadlineMS === undefined ? {} : { deadline_ms: this.shutdownDeadlineMS });
172
+ }
173
+ switch (method) {
174
+ case "health_check":
175
+ return await this.handleHealthCheck(request, params);
176
+ case "shutdown":
177
+ return await this.handleShutdown(request, params);
178
+ case capabilities_js_1.PROVIDE_TOOLS_METHOD:
179
+ return this.handleProvideTools();
180
+ case capabilities_js_1.TOOLS_CALL_METHOD:
181
+ return await this.handleToolCall(request, params);
182
+ case watch_source_js_1.WATCH_POLL_METHOD:
183
+ return await this.watchSources.handlePoll(request, params);
184
+ default:
185
+ return await this.handleUserMethod(method, request, params);
186
+ }
187
+ }
188
+ async handleInitialize(params) {
189
+ if (this.initialized) {
190
+ throw new errors_js_1.InvalidParamsError("initialize may only be called once");
191
+ }
192
+ const request = (0, extension_initialize_js_1.parseInitializeRequest)(params);
193
+ (0, extension_initialize_js_1.validateProtocolVersion)(request);
194
+ const requestedProvides = (0, extension_runtime_js_1.normalizeStringList)(this.definition.capabilities?.provides);
195
+ const requestedPermissions = (0, extension_runtime_js_1.normalizeHostMethodList)(this.definition.permissions?.requires);
196
+ (0, extension_runtime_js_1.ensureSubset)("provides", requestedProvides, request.capabilities.provides);
197
+ (0, extension_runtime_js_1.ensureSubset)("permissions", requestedPermissions, request.capabilities.granted_permissions);
198
+ const implementedMethods = this.getImplementedMethods();
199
+ (0, capabilities_js_1.validateProvidedMethodCoverage)(requestedProvides, implementedMethods);
200
+ const response = {
201
+ protocol_version: "1",
202
+ extension_info: {
203
+ name: this.definition.name,
204
+ version: this.definition.version,
205
+ sdk_name: extension_contract_js_1.SDK_NAME,
206
+ sdk_version: this.sdkVersion,
207
+ },
208
+ accepted_capabilities: {
209
+ provides: requestedProvides,
210
+ permissions: requestedPermissions,
211
+ },
212
+ implemented_methods: implementedMethods,
213
+ supported_hook_events: this.getSupportedHookEvents(),
214
+ ...this.watchSources.initializeResponseFields(),
215
+ supports: {
216
+ health_check: true,
217
+ },
218
+ };
219
+ this.initialized = true;
220
+ this.session = {
221
+ initializeRequest: request,
222
+ initializeResponse: response,
223
+ runtime: request.runtime,
224
+ acceptedCapabilities: response.accepted_capabilities,
225
+ };
226
+ setImmediate(() => {
227
+ void this.finishInitialization();
228
+ });
229
+ return response;
230
+ }
231
+ async finishInitialization() {
232
+ if (!this.session) {
233
+ return;
234
+ }
235
+ for (const callback of this.readyCallbacks) {
236
+ await this.runReadyCallback(callback, this.session);
237
+ }
238
+ this.resolveStart?.(this.host);
239
+ this.resolveStart = undefined;
240
+ this.rejectStart = undefined;
241
+ }
242
+ async runReadyCallback(callback, session) {
243
+ try {
244
+ await callback(this.host, session);
245
+ }
246
+ catch (error) {
247
+ this.logError("onReady callback failed", error);
248
+ }
249
+ }
250
+ async handleHealthCheck(request, params) {
251
+ const customHandler = this.handlers.get("health_check");
252
+ if (!customHandler) {
253
+ return {
254
+ healthy: true,
255
+ message: "",
256
+ details: {},
257
+ };
258
+ }
259
+ return (await customHandler(this.makeContext(request), params));
260
+ }
261
+ async handleShutdown(request, params) {
262
+ const shutdownRequest = (0, extension_runtime_js_1.parseShutdownRequest)(params);
263
+ this.shutdownStarted = true;
264
+ this.shutdownDeadlineMS = shutdownRequest.deadline_ms;
265
+ const customHandler = this.handlers.get("shutdown");
266
+ if (customHandler) {
267
+ const result = (await customHandler(this.makeContext(request), shutdownRequest));
268
+ return result ?? { acknowledged: true };
269
+ }
270
+ return { acknowledged: true };
271
+ }
272
+ handleProvideTools() {
273
+ return {
274
+ tools: this.getToolDescriptors(),
275
+ };
276
+ }
277
+ async handleToolCall(request, params) {
278
+ const call = (0, extension_runtime_js_1.parseToolCallRequest)(params);
279
+ const registered = this.toolHandlers.get(call.handler);
280
+ if (!registered) {
281
+ throw new errors_js_1.MethodNotFoundError(call.handler);
282
+ }
283
+ if (registered.descriptor.id !== call.tool_id) {
284
+ throw new errors_js_1.InvalidParamsError("tool_id does not match handler", {
285
+ expected_tool_id: registered.descriptor.id,
286
+ actual_tool_id: call.tool_id,
287
+ handler: call.handler,
288
+ });
289
+ }
290
+ const context = this.makeContext(request);
291
+ try {
292
+ const result = await registered.handler((0, extension_tool_context_js_1.makeExtensionToolContext)(call, context));
293
+ return { result: (0, extension_runtime_js_1.normalizeToolResult)(result) };
294
+ }
295
+ catch (error) {
296
+ if ((0, errors_js_1.isRPCError)(error)) {
297
+ throw error;
298
+ }
299
+ throw (0, extension_runtime_js_1.toolExecutionError)(error, call, registered.sensitiveInputFields);
300
+ }
301
+ }
302
+ async handleUserMethod(method, request, params) {
303
+ const handler = this.handlers.get(method);
304
+ if (!handler) {
305
+ throw new errors_js_1.MethodNotFoundError(method);
306
+ }
307
+ return await handler(this.makeContext(request), params);
308
+ }
309
+ makeContext(request) {
310
+ return (0, extension_context_js_1.makeExtensionContext)(request, this.host, this.session, this.stderr);
311
+ }
312
+ logError(message, error) {
313
+ (0, extension_context_js_1.writeExtensionError)(this.stderr, message, error);
314
+ }
315
+ ensureToolProviderCapability() {
316
+ const capabilities = this.definition.capabilities ?? {};
317
+ capabilities.provides = (0, extension_runtime_js_1.normalizeStringList)([
318
+ ...(capabilities.provides ?? []),
319
+ capabilities_js_1.TOOL_PROVIDER_CAPABILITY,
320
+ ]);
321
+ this.definition.capabilities = capabilities;
322
+ }
323
+ ensureToolProviderHandlers() {
324
+ this.bindMethod(capabilities_js_1.PROVIDE_TOOLS_METHOD);
325
+ this.bindMethod(capabilities_js_1.TOOLS_CALL_METHOD);
326
+ }
327
+ }
328
+ exports.Extension = Extension;
329
+ //# sourceMappingURL=extension.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/extension.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PUBLIC_PROVIDE_CONFORMANCE_FIXTURES = exports.REQUIRED_METHODS_BY_PROVIDE = void 0;
4
+ exports.REQUIRED_METHODS_BY_PROVIDE = {
5
+ "bridge.adapter": ["bridges/deliver", "bridges/targets/snapshot"],
6
+ "loop.watch_source": ["watch/poll"],
7
+ "memory.backend": ["memory/forget", "memory/recall", "memory/store"],
8
+ "model.source": ["models/list"],
9
+ "tool.provider": ["provide_tools", "tools/call"],
10
+ };
11
+ exports.PUBLIC_PROVIDE_CONFORMANCE_FIXTURES = [
12
+ {
13
+ provide: "loop.watch_source",
14
+ required_methods: exports.REQUIRED_METHODS_BY_PROVIDE["loop.watch_source"],
15
+ },
16
+ { provide: "memory.backend", required_methods: exports.REQUIRED_METHODS_BY_PROVIDE["memory.backend"] },
17
+ { provide: "model.source", required_methods: exports.REQUIRED_METHODS_BY_PROVIDE["model.source"] },
18
+ { provide: "tool.provider", required_methods: exports.REQUIRED_METHODS_BY_PROVIDE["tool.provider"] },
19
+ ];
20
+ //# sourceMappingURL=contracts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/generated/contracts.ts"],"names":[],"mappings":";;;AA03Na,QAAA,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACjE,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;CACc,CAAC;AAOpD,QAAA,mCAAmC,GAAyC;IACvF;QACE,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,mBAAmB,CAAC;KACnE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,cAAc,CAAC,EAAE;IAC1F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,eAAe,CAAC,EAAE;CAC7F,CAAC"}
@@ -0,0 +1,187 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.HostAPI = void 0;
4
+ const errors_js_1 = require("./errors.js");
5
+ async function callHostMethod(transport, method, params, isReady) {
6
+ if (!isReady()) {
7
+ throw new errors_js_1.NotInitializedError();
8
+ }
9
+ return (await transport.call(method, params));
10
+ }
11
+ class HostAPI {
12
+ transport;
13
+ isReady;
14
+ sessions;
15
+ soul;
16
+ heartbeat;
17
+ memory;
18
+ observe;
19
+ logs;
20
+ skills;
21
+ bridges;
22
+ network;
23
+ resources;
24
+ constructor(transport, options = {}) {
25
+ this.transport = transport;
26
+ this.isReady = options.isReady ?? (() => true);
27
+ this.sessions = {
28
+ list: async (params) => await this.request("sessions/list", params),
29
+ create: async (params) => await this.request("sessions/create", params),
30
+ prompt: async (params) => await this.request("sessions/prompt", params),
31
+ stop: async (params) => await this.request("sessions/stop", params),
32
+ status: async (params) => await this.request("sessions/status", params),
33
+ events: async (params) => await this.request("sessions/events", params),
34
+ refreshSoul: async (params) => await this.request("sessions/soul/refresh", params),
35
+ health: async (params) => await this.request("sessions/health/get", params),
36
+ authoredStatus: async (params) => await this.request("sessions/status/get", params),
37
+ };
38
+ this.soul = {
39
+ get: async (params) => await this.request("agents/soul/get", params),
40
+ validate: async (params) => await this.request("agents/soul/validate", params),
41
+ put: async (params) => await this.request("agents/soul/put", params),
42
+ delete: async (params) => await this.request("agents/soul/delete", params),
43
+ history: async (params) => await this.request("agents/soul/history", params),
44
+ rollback: async (params) => await this.request("agents/soul/rollback", params),
45
+ };
46
+ this.heartbeat = {
47
+ get: async (params) => await this.request("agents/heartbeat/get", params),
48
+ validate: async (params) => await this.request("agents/heartbeat/validate", params),
49
+ put: async (params) => await this.request("agents/heartbeat/put", params),
50
+ delete: async (params) => await this.request("agents/heartbeat/delete", params),
51
+ history: async (params) => await this.request("agents/heartbeat/history", params),
52
+ rollback: async (params) => await this.request("agents/heartbeat/rollback", params),
53
+ status: async (params) => await this.request("agents/heartbeat/status", params),
54
+ wake: async (params) => await this.request("agents/heartbeat/wake", params),
55
+ };
56
+ this.memory = {
57
+ recall: async (params) => await this.request("memory/recall", params),
58
+ store: async (params) => await this.request("memory/store", params),
59
+ forget: async (params) => await this.request("memory/forget", params),
60
+ };
61
+ this.observe = {
62
+ health: async () => await this.request("observe/health", undefined),
63
+ };
64
+ this.logs = {
65
+ list: async (params) => await this.request("logs/list", params),
66
+ };
67
+ this.skills = {
68
+ list: async (params) => await this.request("skills/list", params),
69
+ };
70
+ this.bridges = {
71
+ list: async () => await this.request("bridges/instances/list", undefined),
72
+ ingest: async (params) => await this.request("bridges/messages/ingest", params),
73
+ get: async (params) => await this.request("bridges/instances/get", params),
74
+ reportState: async (params) => await this.request("bridges/instances/report_state", params),
75
+ };
76
+ this.network = {
77
+ status: async () => await this.request("network/status", undefined),
78
+ channels: async (params) => await this.request("network/channels", params),
79
+ peers: async (params) => await this.request("network/peers", params),
80
+ threads: async (params) => await this.request("network/threads", params),
81
+ thread: {
82
+ get: async (params) => await this.request("network/thread/get", params),
83
+ messages: async (params) => await this.request("network/thread/messages", params),
84
+ },
85
+ directs: async (params) => await this.request("network/directs", params),
86
+ direct: {
87
+ resolve: async (params) => await this.request("network/direct/resolve", params),
88
+ messages: async (params) => await this.request("network/direct/messages", params),
89
+ },
90
+ work: {
91
+ get: async (params) => await this.request("network/work/get", params),
92
+ },
93
+ send: async (params) => await this.request("network/send", params),
94
+ };
95
+ this.resources = {
96
+ list: async (params) => {
97
+ validateResourcesListParams(params);
98
+ return await this.request("resources/list", params);
99
+ },
100
+ get: async (params) => {
101
+ validateResourceGetParams(params);
102
+ return await this.request("resources/get", params);
103
+ },
104
+ snapshot: async (params) => {
105
+ validateResourcesSnapshotParams(params);
106
+ return await this.request("resources/snapshot", params);
107
+ },
108
+ };
109
+ }
110
+ async request(method, params) {
111
+ return await callHostMethod(this.transport, method, params, this.isReady);
112
+ }
113
+ }
114
+ exports.HostAPI = HostAPI;
115
+ function validateResourcesListParams(params) {
116
+ if (params === undefined) {
117
+ return;
118
+ }
119
+ if (!isRecord(params)) {
120
+ throw new errors_js_1.InvalidParamsError("resources.list params must be an object");
121
+ }
122
+ if (params.kind !== undefined) {
123
+ assertNonEmptyString(params.kind, "resources.list kind");
124
+ }
125
+ if (params.scope !== undefined) {
126
+ validateResourceScope(params.scope, "resources.list scope");
127
+ }
128
+ const limit = params.limit;
129
+ if (limit !== undefined &&
130
+ limit !== null &&
131
+ (typeof limit !== "number" || !Number.isInteger(limit) || limit < 0)) {
132
+ throw new errors_js_1.InvalidParamsError("resources.list limit must be a non-negative integer");
133
+ }
134
+ }
135
+ function validateResourceGetParams(params) {
136
+ if (!isRecord(params)) {
137
+ throw new errors_js_1.InvalidParamsError("resources.get params must be an object");
138
+ }
139
+ assertNonEmptyString(params.kind, "resources.get kind");
140
+ assertNonEmptyString(params.id, "resources.get id");
141
+ }
142
+ function validateResourcesSnapshotParams(params) {
143
+ if (!isRecord(params)) {
144
+ throw new errors_js_1.InvalidParamsError("resources.snapshot params must be an object");
145
+ }
146
+ if (!Number.isInteger(params.source_version) || params.source_version <= 0) {
147
+ throw new errors_js_1.InvalidParamsError("resources.snapshot source_version must be a positive integer");
148
+ }
149
+ if (!Array.isArray(params.records)) {
150
+ throw new errors_js_1.InvalidParamsError("resources.snapshot records must be an array");
151
+ }
152
+ for (const [index, record] of params.records.entries()) {
153
+ if (!isRecord(record)) {
154
+ throw new errors_js_1.InvalidParamsError(`resources.snapshot records[${index}] must be an object`);
155
+ }
156
+ assertNonEmptyString(record.kind, `resources.snapshot records[${index}].kind`);
157
+ assertNonEmptyString(record.id, `resources.snapshot records[${index}].id`);
158
+ validateResourceScope(record.scope, `resources.snapshot records[${index}].scope`);
159
+ if (!Object.prototype.hasOwnProperty.call(record, "spec") || record.spec === undefined) {
160
+ throw new errors_js_1.InvalidParamsError(`resources.snapshot records[${index}].spec is required`);
161
+ }
162
+ }
163
+ }
164
+ function validateResourceScope(scope, field) {
165
+ if (!isRecord(scope)) {
166
+ throw new errors_js_1.InvalidParamsError(`${field} must be an object`);
167
+ }
168
+ if (scope.kind !== "global" && scope.kind !== "workspace") {
169
+ throw new errors_js_1.InvalidParamsError(`${field}.kind must be "global" or "workspace"`);
170
+ }
171
+ const id = typeof scope.id === "string" ? scope.id.trim() : "";
172
+ if (scope.kind === "global" && id !== "") {
173
+ throw new errors_js_1.InvalidParamsError(`${field}.id must be empty for global scope`);
174
+ }
175
+ if (scope.kind === "workspace" && id === "") {
176
+ throw new errors_js_1.InvalidParamsError(`${field}.id is required for workspace scope`);
177
+ }
178
+ }
179
+ function assertNonEmptyString(value, field) {
180
+ if (typeof value !== "string" || value.trim() === "") {
181
+ throw new errors_js_1.InvalidParamsError(`${field} is required`);
182
+ }
183
+ }
184
+ function isRecord(value) {
185
+ return typeof value === "object" && value !== null;
186
+ }
187
+ //# sourceMappingURL=host-api.js.map