@openwaggle/extension-sdk 0.0.0-bootstrap.0 → 0.1.0

package/dist-cjs/docs-validation.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDocsDiscoverResult = isDocsDiscoverResult;
+exports.isDocsResolveTopicResult = isDocsResolveTopicResult;
+const constants_js_1 = require("./constants.js");
+const internal_validation_js_1 = require("./internal-validation.js");
+function isStringOrNull(value) {
+    return value === null || typeof value === 'string';
+}
+function isOptionalNonEmptyString(value) {
+    return value === undefined || (0, internal_validation_js_1.isNonEmptyString)(value);
+}
+function hasOpenWaggleResultBase(value, capability, method) {
+    return ((0, internal_validation_js_1.isNonEmptyString)(value.extensionId) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.contributionId) &&
+        value.capability === capability &&
+        value.method === method);
+}
+function isDocsDiscoveryDiagnostic(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        (value.severity === 'warning' || value.severity === 'error') &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.code) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.message) &&
+        isOptionalNonEmptyString(value.path));
+}
+function isFirstPartyDocsTopicSummary(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.topic) &&
+        (value.source === 'openwaggle' || value.source === 'pi') &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.group) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.title) &&
+        isOptionalNonEmptyString(value.description) &&
+        isOptionalNonEmptyString(value.section) &&
+        typeof value.order === 'number' &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.path) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.bundlePath) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.sourcePath) &&
+        (0, internal_validation_js_1.isStringArray)(value.aliases) &&
+        (0, internal_validation_js_1.isStringArray)(value.keywords) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.contentHash));
+}
+function isExtensionDocsPackageScopeView(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        (value.kind === 'global' || value.kind === 'project') &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.label) &&
+        isOptionalNonEmptyString(value.projectPath));
+}
+function isExtensionDocsProvenance(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.extensionId) &&
+        isStringOrNull(value.extensionName) &&
+        isStringOrNull(value.extensionVersion) &&
+        isExtensionDocsPackageScopeView(value.scope) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.packagePath) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.manifestPath) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.path) &&
+        isStringOrNull(value.packageContentHash) &&
+        (value.trust === 'trusted' || value.trust === 'untrusted' || value.trust === 'unknown') &&
+        (value.lifecycle === 'enabled' ||
+            value.lifecycle === 'disabled' ||
+            value.lifecycle === 'unavailable'));
+}
+function isExtensionDocsTopicSummary(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.topic) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.localTopic) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.title) &&
+        isOptionalNonEmptyString(value.description) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.path) &&
+        (0, internal_validation_js_1.isStringArray)(value.aliases) &&
+        (0, internal_validation_js_1.isStringArray)(value.keywords) &&
+        isStringOrNull(value.contentHash) &&
+        isExtensionDocsProvenance(value.provenance) &&
+        Array.isArray(value.diagnostics) &&
+        value.diagnostics.every(isDocsDiscoveryDiagnostic));
+}
+function isDocsDiscoveryView(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.generatedAt) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.bundlePath) &&
+        Array.isArray(value.firstPartyTopics) &&
+        value.firstPartyTopics.every(isFirstPartyDocsTopicSummary) &&
+        Array.isArray(value.extensionTopics) &&
+        value.extensionTopics.every(isExtensionDocsTopicSummary) &&
+        Array.isArray(value.diagnostics) &&
+        value.diagnostics.every(isDocsDiscoveryDiagnostic));
+}
+function isDocsDiscoverResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasOpenWaggleResultBase(value, constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.DOCS, constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.DISCOVER_DOCS) &&
+        isDocsDiscoveryView(value.docs));
+}
+function isDocsResolveTopicResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasOpenWaggleResultBase(value, constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.DOCS, constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.RESOLVE_DOCS_TOPIC) &&
+        (value.resolvedTopic === null || isFirstPartyDocsTopicSummary(value.resolvedTopic)));
+}

package/dist-cjs/docs.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extensionDocsResolveTopicResultSchema = exports.extensionDocsDiscoverResultSchema = exports.docsDiscoveryViewSchema = exports.extensionDocsTopicSummarySchema = exports.extensionDocsProvenanceSchema = exports.extensionDocsPackageScopeViewSchema = exports.firstPartyDocsTopicSummarySchema = exports.docsDiscoveryDiagnosticSchema = exports.extensionDocsResolveTopicPayloadSchema = exports.extensionDocsDiscoverPayloadSchema = exports.firstPartyDocTopicSchema = void 0;
+const Schema = __importStar(require("effect/Schema"));
+const constants_js_1 = require("./constants.js");
+const manifest_js_1 = require("./manifest.js");
+const nonEmptyStringSchema = Schema.String.pipe(Schema.minLength(1));
+const EXTENSION_TOPIC_PREFIX = 'extension:';
+exports.firstPartyDocTopicSchema = nonEmptyStringSchema.pipe(Schema.filter((value) => !value.startsWith(EXTENSION_TOPIC_PREFIX) ||
+    'Extension docs topics must be resolved through extension docs discovery.'));
+exports.extensionDocsDiscoverPayloadSchema = Schema.Struct({
+    projectPaths: Schema.optional(Schema.Array(nonEmptyStringSchema)),
+    includeExtensions: Schema.optional(Schema.Boolean),
+});
+exports.extensionDocsResolveTopicPayloadSchema = Schema.Struct({
+    topic: exports.firstPartyDocTopicSchema,
+});
+exports.docsDiscoveryDiagnosticSchema = Schema.Struct({
+    severity: Schema.Literal('warning', 'error'),
+    code: nonEmptyStringSchema,
+    message: nonEmptyStringSchema,
+    path: Schema.optional(nonEmptyStringSchema),
+});
+exports.firstPartyDocsTopicSummarySchema = Schema.Struct({
+    topic: exports.firstPartyDocTopicSchema,
+    source: Schema.Literal('openwaggle', 'pi'),
+    group: nonEmptyStringSchema,
+    title: nonEmptyStringSchema,
+    description: Schema.optional(nonEmptyStringSchema),
+    section: Schema.optional(nonEmptyStringSchema),
+    order: Schema.Number,
+    path: nonEmptyStringSchema,
+    bundlePath: nonEmptyStringSchema,
+    sourcePath: nonEmptyStringSchema,
+    aliases: Schema.Array(nonEmptyStringSchema),
+    keywords: Schema.Array(nonEmptyStringSchema),
+    contentHash: nonEmptyStringSchema,
+});
+exports.extensionDocsPackageScopeViewSchema = Schema.Struct({
+    kind: Schema.Literal(constants_js_1.OPENWAGGLE_EXTENSION.SCOPE.GLOBAL_KIND, constants_js_1.OPENWAGGLE_EXTENSION.SCOPE.PROJECT_KIND),
+    label: nonEmptyStringSchema,
+    projectPath: Schema.optional(nonEmptyStringSchema),
+});
+exports.extensionDocsProvenanceSchema = Schema.Struct({
+    extensionId: manifest_js_1.extensionIdSchema,
+    extensionName: Schema.NullOr(nonEmptyStringSchema),
+    extensionVersion: Schema.NullOr(nonEmptyStringSchema),
+    scope: exports.extensionDocsPackageScopeViewSchema,
+    packagePath: nonEmptyStringSchema,
+    manifestPath: nonEmptyStringSchema,
+    path: nonEmptyStringSchema,
+    packageContentHash: Schema.NullOr(nonEmptyStringSchema),
+    trust: Schema.Literal('trusted', 'untrusted', 'unknown'),
+    lifecycle: Schema.Literal('enabled', 'disabled', 'unavailable'),
+});
+exports.extensionDocsTopicSummarySchema = Schema.Struct({
+    topic: nonEmptyStringSchema,
+    localTopic: nonEmptyStringSchema,
+    title: nonEmptyStringSchema,
+    description: Schema.optional(nonEmptyStringSchema),
+    path: nonEmptyStringSchema,
+    aliases: Schema.Array(nonEmptyStringSchema),
+    keywords: Schema.Array(nonEmptyStringSchema),
+    contentHash: Schema.NullOr(nonEmptyStringSchema),
+    provenance: exports.extensionDocsProvenanceSchema,
+    diagnostics: Schema.Array(exports.docsDiscoveryDiagnosticSchema),
+});
+exports.docsDiscoveryViewSchema = Schema.Struct({
+    generatedAt: nonEmptyStringSchema,
+    bundlePath: nonEmptyStringSchema,
+    firstPartyTopics: Schema.Array(exports.firstPartyDocsTopicSummarySchema),
+    extensionTopics: Schema.Array(exports.extensionDocsTopicSummarySchema),
+    diagnostics: Schema.Array(exports.docsDiscoveryDiagnosticSchema),
+});
+exports.extensionDocsDiscoverResultSchema = Schema.Struct({
+    extensionId: manifest_js_1.extensionIdSchema,
+    contributionId: manifest_js_1.extensionContributionIdSchema,
+    capability: Schema.Literal(constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.DOCS),
+    method: Schema.Literal(constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.DISCOVER_DOCS),
+    docs: exports.docsDiscoveryViewSchema,
+});
+exports.extensionDocsResolveTopicResultSchema = Schema.Struct({
+    extensionId: manifest_js_1.extensionIdSchema,
+    contributionId: manifest_js_1.extensionContributionIdSchema,
+    capability: Schema.Literal(constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.DOCS),
+    method: Schema.Literal(constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.RESOLVE_DOCS_TOPIC),
+    resolvedTopic: Schema.NullOr(exports.firstPartyDocsTopicSummarySchema),
+});

package/dist-cjs/index.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openWaggleExtensionClassName = exports.OPENWAGGLE_EXTENSION_UI_CLASS_NAMES = exports.OPENWAGGLE_EXTENSION_UI_ATTRIBUTES = exports.extensionThemeCssVariableDeclarations = exports.createOpenWaggleExtensionUiStylesheet = exports.OPENWAGGLE_EXTENSION_THEME_CSS_VARIABLES = exports.isOpenWaggleExtensionTheme = exports.extensionThemeCssVariableEntries = exports.createOpenWaggleExtensionTheme = exports.extensionRuntimeUnregisterContributionResultSchema = exports.extensionRuntimeRegisterContributionResultSchema = exports.createRuntimeContributionSdk = exports.jsonValueSchema = exports.jsonPrimitiveSchema = exports.createOpenWaggleExtensionSurfaceContext = exports.createOpenWaggleExtensionSharedModules = exports.createNoopExtensionSurfaceSdk = exports.OPENWAGGLE_EXTENSION_BROKER = exports.OPENWAGGLE_EXTENSION = exports.toInvokeInput = exports.extensionInvokeSuccessSchema = exports.extensionInvokeScopeSchema = exports.extensionInvokeResultSchema = exports.extensionInvokeInputSchema = exports.extensionInvokeFailureSchema = exports.extensionInvokeErrorSchema = exports.extensionCapabilityAuditEntrySchema = exports.createExtensionBrokerSdkFromInvoke = exports.createExtensionBrokerSdk = void 0;
+__exportStar(require("./agent-loop.js"), exports);
+var broker_js_1 = require("./broker.js");
+Object.defineProperty(exports, "createExtensionBrokerSdk", { enumerable: true, get: function () { return broker_js_1.createExtensionBrokerSdk; } });
+Object.defineProperty(exports, "createExtensionBrokerSdkFromInvoke", { enumerable: true, get: function () { return broker_js_1.createExtensionBrokerSdkFromInvoke; } });
+Object.defineProperty(exports, "extensionCapabilityAuditEntrySchema", { enumerable: true, get: function () { return broker_js_1.extensionCapabilityAuditEntrySchema; } });
+Object.defineProperty(exports, "extensionInvokeErrorSchema", { enumerable: true, get: function () { return broker_js_1.extensionInvokeErrorSchema; } });
+Object.defineProperty(exports, "extensionInvokeFailureSchema", { enumerable: true, get: function () { return broker_js_1.extensionInvokeFailureSchema; } });
+Object.defineProperty(exports, "extensionInvokeInputSchema", { enumerable: true, get: function () { return broker_js_1.extensionInvokeInputSchema; } });
+Object.defineProperty(exports, "extensionInvokeResultSchema", { enumerable: true, get: function () { return broker_js_1.extensionInvokeResultSchema; } });
+Object.defineProperty(exports, "extensionInvokeScopeSchema", { enumerable: true, get: function () { return broker_js_1.extensionInvokeScopeSchema; } });
+Object.defineProperty(exports, "extensionInvokeSuccessSchema", { enumerable: true, get: function () { return broker_js_1.extensionInvokeSuccessSchema; } });
+Object.defineProperty(exports, "toInvokeInput", { enumerable: true, get: function () { return broker_js_1.toInvokeInput; } });
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "OPENWAGGLE_EXTENSION", { enumerable: true, get: function () { return constants_js_1.OPENWAGGLE_EXTENSION; } });
+Object.defineProperty(exports, "OPENWAGGLE_EXTENSION_BROKER", { enumerable: true, get: function () { return constants_js_1.OPENWAGGLE_EXTENSION_BROKER; } });
+var context_js_1 = require("./context.js");
+Object.defineProperty(exports, "createNoopExtensionSurfaceSdk", { enumerable: true, get: function () { return context_js_1.createNoopExtensionSurfaceSdk; } });
+Object.defineProperty(exports, "createOpenWaggleExtensionSharedModules", { enumerable: true, get: function () { return context_js_1.createOpenWaggleExtensionSharedModules; } });
+Object.defineProperty(exports, "createOpenWaggleExtensionSurfaceContext", { enumerable: true, get: function () { return context_js_1.createOpenWaggleExtensionSurfaceContext; } });
+__exportStar(require("./docs.js"), exports);
+var json_js_1 = require("./json.js");
+Object.defineProperty(exports, "jsonPrimitiveSchema", { enumerable: true, get: function () { return json_js_1.jsonPrimitiveSchema; } });
+Object.defineProperty(exports, "jsonValueSchema", { enumerable: true, get: function () { return json_js_1.jsonValueSchema; } });
+__exportStar(require("./manifest.js"), exports);
+var runtime_js_1 = require("./runtime.js");
+Object.defineProperty(exports, "createRuntimeContributionSdk", { enumerable: true, get: function () { return runtime_js_1.createRuntimeContributionSdk; } });
+Object.defineProperty(exports, "extensionRuntimeRegisterContributionResultSchema", { enumerable: true, get: function () { return runtime_js_1.extensionRuntimeRegisterContributionResultSchema; } });
+Object.defineProperty(exports, "extensionRuntimeUnregisterContributionResultSchema", { enumerable: true, get: function () { return runtime_js_1.extensionRuntimeUnregisterContributionResultSchema; } });
+var theme_js_1 = require("./theme.js");
+Object.defineProperty(exports, "createOpenWaggleExtensionTheme", { enumerable: true, get: function () { return theme_js_1.createOpenWaggleExtensionTheme; } });
+Object.defineProperty(exports, "extensionThemeCssVariableEntries", { enumerable: true, get: function () { return theme_js_1.extensionThemeCssVariableEntries; } });
+Object.defineProperty(exports, "isOpenWaggleExtensionTheme", { enumerable: true, get: function () { return theme_js_1.isOpenWaggleExtensionTheme; } });
+Object.defineProperty(exports, "OPENWAGGLE_EXTENSION_THEME_CSS_VARIABLES", { enumerable: true, get: function () { return theme_js_1.OPENWAGGLE_EXTENSION_THEME_CSS_VARIABLES; } });
+var ui_js_1 = require("./ui.js");
+Object.defineProperty(exports, "createOpenWaggleExtensionUiStylesheet", { enumerable: true, get: function () { return ui_js_1.createOpenWaggleExtensionUiStylesheet; } });
+Object.defineProperty(exports, "extensionThemeCssVariableDeclarations", { enumerable: true, get: function () { return ui_js_1.extensionThemeCssVariableDeclarations; } });
+Object.defineProperty(exports, "OPENWAGGLE_EXTENSION_UI_ATTRIBUTES", { enumerable: true, get: function () { return ui_js_1.OPENWAGGLE_EXTENSION_UI_ATTRIBUTES; } });
+Object.defineProperty(exports, "OPENWAGGLE_EXTENSION_UI_CLASS_NAMES", { enumerable: true, get: function () { return ui_js_1.OPENWAGGLE_EXTENSION_UI_CLASS_NAMES; } });
+Object.defineProperty(exports, "openWaggleExtensionClassName", { enumerable: true, get: function () { return ui_js_1.openWaggleExtensionClassName; } });

package/dist-cjs/internal-validation.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecord = isRecord;
+exports.isNonEmptyString = isNonEmptyString;
+exports.isStringArray = isStringArray;
+exports.isJsonValue = isJsonValue;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isJsonValue(value) {
+    if (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        typeof value === 'number') {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.every(isJsonValue);
+    }
+    if (!isRecord(value)) {
+        return false;
+    }
+    return Object.values(value).every(isJsonValue);
+}

package/dist-cjs/json.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonValueSchema = exports.jsonPrimitiveSchema = void 0;
+const Schema = __importStar(require("effect/Schema"));
+exports.jsonPrimitiveSchema = Schema.Union(Schema.String, Schema.Number, Schema.Boolean, Schema.Null);
+exports.jsonValueSchema = Schema.suspend(() => Schema.Union(exports.jsonPrimitiveSchema, Schema.mutable(Schema.Array(exports.jsonValueSchema)), Schema.mutable(Schema.Record({ key: Schema.String, value: exports.jsonValueSchema }))));

package/dist-cjs/manifest-contributions.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extensionContributionUnregistrationSchema = exports.extensionContributionRegistrationSchema = exports.extensionSlotContributionRegistrationSchema = exports.extensionRouteContributionRegistrationSchema = exports.extensionCommandContributionRegistrationSchema = exports.extensionContributionsSchema = exports.extensionSlotContributionSchema = exports.extensionRouteContributionSchema = exports.extensionCommandContributionSchema = exports.extensionCapabilityDeclarationSchema = void 0;
+const Schema = __importStar(require("effect/Schema"));
+const constants_js_1 = require("./constants.js");
+const manifest_primitives_js_1 = require("./manifest-primitives.js");
+exports.extensionCapabilityDeclarationSchema = Schema.Struct({
+    id: manifest_primitives_js_1.extensionContributionIdSchema,
+    methods: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionContributionIdSchema)),
+    scopes: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionCapabilityScopeSchema)),
+}).pipe(Schema.filter(manifest_primitives_js_1.validateBrokerCapabilityDeclaration));
+const brokerBindingSchema = {
+    capability: Schema.optional(manifest_primitives_js_1.extensionContributionIdSchema),
+    method: Schema.optional(manifest_primitives_js_1.extensionContributionIdSchema),
+    methods: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionContributionIdSchema)),
+};
+const targetSchema = Schema.Struct({
+    projectPaths: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionNonEmptyStringSchema)),
+    sessionIds: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionNonEmptyStringSchema)),
+});
+const matchSchema = Schema.Struct({
+    toolNames: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionNonEmptyStringSchema)),
+    customMessageNames: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionNonEmptyStringSchema)),
+    interactionKinds: Schema.optional(Schema.Array(manifest_primitives_js_1.extensionNonEmptyStringSchema)),
+});
+function validateEntryRuntime(input) {
+    return (input.runtime !== constants_js_1.OPENWAGGLE_EXTENSION.CONTRIBUTION_RUNTIME.TRUSTED_RENDERER ||
+        input.execution === constants_js_1.OPENWAGGLE_EXTENSION.EXECUTION_PLACEMENT.HOST_RENDERER ||
+        'Trusted renderer contributions must execute in the host renderer.');
+}
+exports.extensionCommandContributionSchema = Schema.Struct({
+    id: manifest_primitives_js_1.extensionContributionIdSchema,
+    title: manifest_primitives_js_1.extensionNonEmptyStringSchema.pipe(Schema.maxLength(constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.NAME_MAX_LENGTH)),
+    category: Schema.optional(manifest_primitives_js_1.extensionNonEmptyStringSchema.pipe(Schema.maxLength(constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.NAME_MAX_LENGTH))),
+    target: Schema.optional(targetSchema),
+    ...brokerBindingSchema,
+});
+exports.extensionRouteContributionSchema = Schema.Struct({
+    id: manifest_primitives_js_1.extensionContributionIdSchema,
+    title: manifest_primitives_js_1.extensionNonEmptyStringSchema.pipe(Schema.maxLength(constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.NAME_MAX_LENGTH)),
+    runtime: manifest_primitives_js_1.extensionContributionRuntimeSchema,
+    execution: manifest_primitives_js_1.extensionExecutionPlacementSchema,
+    entry: manifest_primitives_js_1.extensionContributionEntryPathSchema,
+    target: Schema.optional(targetSchema),
+    matches: Schema.optional(matchSchema),
+    ...brokerBindingSchema,
+}).pipe(Schema.filter(validateEntryRuntime));
+exports.extensionSlotContributionSchema = exports.extensionRouteContributionSchema;
+exports.extensionContributionsSchema = Schema.Struct({
+    commands: Schema.optional(Schema.Array(exports.extensionCommandContributionSchema)),
+    slashCommands: Schema.optional(Schema.Array(exports.extensionCommandContributionSchema)),
+    routes: Schema.optional(Schema.Array(exports.extensionRouteContributionSchema)),
+    settingsSections: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    sidePanels: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    dialogs: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    transcriptRenderers: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    toolRenderers: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    customMessageRenderers: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    interactionRenderers: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+    statusWidgets: Schema.optional(Schema.Array(exports.extensionSlotContributionSchema)),
+});
+exports.extensionCommandContributionRegistrationSchema = Schema.Struct({
+    family: manifest_primitives_js_1.extensionCommandContributionFamilySchema,
+    contribution: exports.extensionCommandContributionSchema,
+});
+exports.extensionRouteContributionRegistrationSchema = Schema.Struct({
+    family: Schema.Literal(constants_js_1.OPENWAGGLE_EXTENSION.CONTRIBUTION_FAMILY.ROUTES),
+    contribution: exports.extensionRouteContributionSchema,
+});
+exports.extensionSlotContributionRegistrationSchema = Schema.Struct({
+    family: manifest_primitives_js_1.extensionSlotContributionFamilySchema,
+    contribution: exports.extensionSlotContributionSchema,
+});
+exports.extensionContributionRegistrationSchema = Schema.Union(exports.extensionCommandContributionRegistrationSchema, exports.extensionRouteContributionRegistrationSchema, exports.extensionSlotContributionRegistrationSchema);
+exports.extensionContributionUnregistrationSchema = Schema.Struct({
+    family: manifest_primitives_js_1.extensionContributionFamilySchema,
+    contributionId: manifest_primitives_js_1.extensionContributionIdSchema,
+});

package/dist-cjs/manifest-primitives.js

@@ -0,0 +1,158 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extensionSlotContributionFamilySchema = exports.extensionCommandContributionFamilySchema = exports.extensionContributionFamilySchema = exports.extensionExecutionPlacementSchema = exports.extensionContributionRuntimeSchema = exports.extensionCapabilityScopeSchema = exports.extensionContributionEntryPathSchema = exports.extensionRelativePathSchema = exports.extensionSemverVersionSchema = exports.extensionContributionIdSchema = exports.extensionIdSchema = exports.extensionNonEmptyStringSchema = void 0;
+exports.isBuildCommand = isBuildCommand;
+exports.isRuntimeRequirementBinary = isRuntimeRequirementBinary;
+exports.isNetworkOrigin = isNetworkOrigin;
+exports.validateBrokerCapabilityDeclaration = validateBrokerCapabilityDeclaration;
+const Schema = __importStar(require("effect/Schema"));
+const constants_js_1 = require("./constants.js");
+exports.extensionNonEmptyStringSchema = Schema.String.pipe(Schema.minLength(1), Schema.filter((value) => value.trim().length > 0 || 'Must not be empty.'));
+function isExtensionId(value) {
+    if (value.length > constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.ID_MAX_LENGTH) {
+        return `Must be at most ${constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.ID_MAX_LENGTH} characters.`;
+    }
+    return (constants_js_1.OPENWAGGLE_EXTENSION.PATTERNS.ID.test(value) ||
+        'Use lowercase letters, numbers, dots, underscores, and dashes; start with a letter or number.');
+}
+function isContributionId(value) {
+    if (value.length > constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.CONTRIBUTION_ID_MAX_LENGTH) {
+        return `Must be at most ${constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.CONTRIBUTION_ID_MAX_LENGTH} characters.`;
+    }
+    return (constants_js_1.OPENWAGGLE_EXTENSION.PATTERNS.CONTRIBUTION_ID.test(value) ||
+        'Use lowercase letters, numbers, dots, underscores, dashes, and forward slashes; start with a letter or number.');
+}
+function isSemverVersion(value) {
+    return (constants_js_1.OPENWAGGLE_EXTENSION.PATTERNS.SEMVER_VERSION.test(value) ||
+        'Must be a semantic version such as 1.2.3.');
+}
+function isPortableRelativePath(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return 'Must not be empty.';
+    if (value !== trimmed)
+        return 'Must not have leading or trailing whitespace.';
+    if (trimmed.length > constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.RELATIVE_PATH_MAX_LENGTH) {
+        return `Must be at most ${constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.RELATIVE_PATH_MAX_LENGTH} characters.`;
+    }
+    if (trimmed.includes(constants_js_1.OPENWAGGLE_EXTENSION.PATH.NUL_CHARACTER)) {
+        return 'Must not contain NUL bytes.';
+    }
+    if (trimmed.startsWith(constants_js_1.OPENWAGGLE_EXTENSION.PATH.POSIX_SEPARATOR) ||
+        trimmed.startsWith(constants_js_1.OPENWAGGLE_EXTENSION.PATH.WINDOWS_SEPARATOR) ||
+        constants_js_1.OPENWAGGLE_EXTENSION.PATTERNS.WINDOWS_ABSOLUTE_PATH.test(trimmed)) {
+        return 'Must be relative to the extension package root.';
+    }
+    const segments = trimmed
+        .replaceAll(constants_js_1.OPENWAGGLE_EXTENSION.PATH.WINDOWS_SEPARATOR, constants_js_1.OPENWAGGLE_EXTENSION.PATH.POSIX_SEPARATOR)
+        .split(constants_js_1.OPENWAGGLE_EXTENSION.PATH.POSIX_SEPARATOR);
+    return (!segments.some((segment) => segment.length === 0 ||
+        segment === constants_js_1.OPENWAGGLE_EXTENSION.PATH.CURRENT_DIRECTORY_SEGMENT ||
+        segment === constants_js_1.OPENWAGGLE_EXTENSION.PATH.RELATIVE_PARENT_SEGMENT) || 'Must not contain empty, "." or ".." path segments.');
+}
+function isBuildCommand(value) {
+    if (value.length > constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.BUILD_COMMAND_MAX_LENGTH) {
+        return `Must be at most ${constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.BUILD_COMMAND_MAX_LENGTH} characters.`;
+    }
+    if (value.includes(constants_js_1.OPENWAGGLE_EXTENSION.PATH.NUL_CHARACTER)) {
+        return 'Must not contain NUL bytes.';
+    }
+    return (!value.includes('\n') && !value.includes('\r')) || 'Must be a single command line.';
+}
+function isRuntimeRequirementBinary(value) {
+    const trimmed = value.trim();
+    if (value !== trimmed)
+        return 'Must not have leading or trailing whitespace.';
+    if (value.length > constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.RUNTIME_REQUIREMENT_BINARY_MAX_LENGTH) {
+        return `Must be at most ${constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.RUNTIME_REQUIREMENT_BINARY_MAX_LENGTH} characters.`;
+    }
+    if (value.includes(constants_js_1.OPENWAGGLE_EXTENSION.PATH.NUL_CHARACTER)) {
+        return 'Must not contain NUL bytes.';
+    }
+    if (value.includes('\n') || value.includes('\r'))
+        return 'Must be a single executable name.';
+    return ((!value.includes(constants_js_1.OPENWAGGLE_EXTENSION.PATH.POSIX_SEPARATOR) &&
+        !value.includes(constants_js_1.OPENWAGGLE_EXTENSION.PATH.WINDOWS_SEPARATOR)) ||
+        'Must be an executable name, not a path.');
+}
+function isNetworkOrigin(value) {
+    const trimmed = value.trim();
+    if (value !== trimmed)
+        return 'Must not have leading or trailing whitespace.';
+    if (value.length > constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.NETWORK_ORIGIN_MAX_LENGTH) {
+        return `Must be at most ${constants_js_1.OPENWAGGLE_EXTENSION.LIMITS.NETWORK_ORIGIN_MAX_LENGTH} characters.`;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return 'Must be a valid URL origin.';
+    }
+    if (url.protocol !== 'https:')
+        return 'Must use https.';
+    return (url.origin === value ||
+        'Must be an exact origin without a path, query, fragment, or trailing slash.');
+}
+function validateBrokerCapabilityDeclaration(declaration) {
+    const supportedMethods = constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY_METHODS.find((descriptor) => descriptor.capability === declaration.id)?.methods ?? null;
+    if (supportedMethods === null)
+        return true;
+    if (declaration.methods === undefined || declaration.methods.length === 0) {
+        return `Built-in broker capability "${declaration.id}" must declare at least one supported method.`;
+    }
+    const unsupportedMethod = declaration.methods.find((declaredMethod) => !supportedMethods.some((method) => method === declaredMethod));
+    return (unsupportedMethod === undefined ||
+        `Built-in broker capability "${declaration.id}" does not support method "${unsupportedMethod}".`);
+}
+function isNotRuntimeModuleContextEntryPath(value) {
+    const [firstSegment] = value
+        .replaceAll(constants_js_1.OPENWAGGLE_EXTENSION.PATH.WINDOWS_SEPARATOR, constants_js_1.OPENWAGGLE_EXTENSION.PATH.POSIX_SEPARATOR)
+        .split(constants_js_1.OPENWAGGLE_EXTENSION.PATH.POSIX_SEPARATOR);
+    return (firstSegment !== constants_js_1.OPENWAGGLE_EXTENSION.RUNTIME_MODULE_PROTOCOL.MODULE_CONTEXT_SEGMENT ||
+        `Must not start with the reserved "${constants_js_1.OPENWAGGLE_EXTENSION.RUNTIME_MODULE_PROTOCOL.MODULE_CONTEXT_SEGMENT}" runtime module path segment.`);
+}
+exports.extensionIdSchema = Schema.String.pipe(Schema.minLength(1), Schema.filter(isExtensionId));
+exports.extensionContributionIdSchema = Schema.String.pipe(Schema.minLength(1), Schema.filter(isContributionId));
+exports.extensionSemverVersionSchema = Schema.String.pipe(Schema.minLength(1), Schema.filter(isSemverVersion));
+exports.extensionRelativePathSchema = Schema.String.pipe(Schema.minLength(1), Schema.filter(isPortableRelativePath));
+exports.extensionContributionEntryPathSchema = exports.extensionRelativePathSchema.pipe(Schema.filter(isNotRuntimeModuleContextEntryPath));
+exports.extensionCapabilityScopeSchema = Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION.CAPABILITY_SCOPES);
+exports.extensionContributionRuntimeSchema = Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION.CONTRIBUTION_RUNTIMES);
+exports.extensionExecutionPlacementSchema = Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION.EXECUTION_PLACEMENTS);
+exports.extensionContributionFamilySchema = Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION.CONTRIBUTION_FAMILIES);
+exports.extensionCommandContributionFamilySchema = Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION.COMMAND_CONTRIBUTION_FAMILIES);
+exports.extensionSlotContributionFamilySchema = Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION.SLOT_CONTRIBUTION_FAMILIES);