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

package/dist-cjs/agent-loop.js

@@ -0,0 +1,83 @@
+"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.openWaggleAgentLoopSurfaceInputSchema = exports.openWaggleStatusSurfaceInputSchema = exports.openWaggleTranscriptSurfaceInputSchema = exports.openWaggleInteractionSurfaceInputSchema = exports.openWaggleCustomMessageSurfaceInputSchema = exports.openWaggleToolCallSurfaceInputSchema = void 0;
+const Schema = __importStar(require("effect/Schema"));
+const json_js_1 = require("./json.js");
+const nonEmptyStringSchema = Schema.String.pipe(Schema.minLength(1));
+exports.openWaggleToolCallSurfaceInputSchema = Schema.Struct({
+    surface: Schema.Literal('tool'),
+    toolCall: Schema.Struct({
+        id: nonEmptyStringSchema,
+        name: nonEmptyStringSchema,
+        input: Schema.optional(json_js_1.jsonValueSchema),
+    }),
+    toolResult: Schema.optional(Schema.Struct({
+        ok: Schema.Boolean,
+        output: Schema.optional(json_js_1.jsonValueSchema),
+        error: Schema.optional(Schema.String),
+    })),
+});
+exports.openWaggleCustomMessageSurfaceInputSchema = Schema.Struct({
+    surface: Schema.Literal('custom-message'),
+    message: Schema.Struct({
+        name: nonEmptyStringSchema,
+        payload: Schema.optional(json_js_1.jsonValueSchema),
+    }),
+});
+exports.openWaggleInteractionSurfaceInputSchema = Schema.Struct({
+    surface: Schema.Literal('interaction'),
+    interaction: Schema.Struct({
+        id: nonEmptyStringSchema,
+        customType: nonEmptyStringSchema,
+        payload: Schema.optional(json_js_1.jsonValueSchema),
+    }),
+});
+exports.openWaggleTranscriptSurfaceInputSchema = Schema.Struct({
+    surface: Schema.Literal('transcript'),
+    transcript: Schema.Struct({
+        sessionId: Schema.optional(nonEmptyStringSchema),
+        messageCount: Schema.Number,
+        payload: Schema.optional(json_js_1.jsonValueSchema),
+    }),
+});
+exports.openWaggleStatusSurfaceInputSchema = Schema.Struct({
+    surface: Schema.Literal('status'),
+    status: Schema.Struct({
+        label: nonEmptyStringSchema,
+        payload: Schema.optional(json_js_1.jsonValueSchema),
+    }),
+});
+exports.openWaggleAgentLoopSurfaceInputSchema = Schema.Union(exports.openWaggleToolCallSurfaceInputSchema, exports.openWaggleCustomMessageSurfaceInputSchema, exports.openWaggleInteractionSurfaceInputSchema, exports.openWaggleTranscriptSurfaceInputSchema, exports.openWaggleStatusSurfaceInputSchema);

package/dist-cjs/broker-validation.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invalidOperationResult = invalidOperationResult;
+exports.toDecodedOperationResult = toDecodedOperationResult;
+exports.isStorageGetResult = isStorageGetResult;
+exports.isStorageSetResult = isStorageSetResult;
+exports.isStorageDeleteResult = isStorageDeleteResult;
+exports.isStorageListResult = isStorageListResult;
+exports.isRuntimeRegisterContributionResult = isRuntimeRegisterContributionResult;
+exports.isRuntimeUnregisterContributionResult = isRuntimeUnregisterContributionResult;
+const constants_js_1 = require("./constants.js");
+const internal_validation_js_1 = require("./internal-validation.js");
+function invalidOperationResult(input) {
+    return {
+        ok: false,
+        error: {
+            code: constants_js_1.OPENWAGGLE_EXTENSION_BROKER.FAILURE_CODE.INVALID_PAYLOAD,
+            message: input.message,
+            issues: [...input.issues],
+        },
+        audit: input.audit,
+    };
+}
+function toDecodedOperationResult(result, guard, message) {
+    if (!result.ok) {
+        return result;
+    }
+    return guard(result.value)
+        ? { ok: true, value: result.value, audit: result.audit }
+        : invalidOperationResult({
+            audit: result.audit,
+            issues: ['Broker response payload did not match the expected operation result.'],
+            message,
+        });
+}
+function isKnownString(values, value) {
+    return typeof value === 'string' && values.some((candidate) => candidate === value);
+}
+function isStorageScope(value) {
+    if (!(0, internal_validation_js_1.isRecord)(value)) {
+        return false;
+    }
+    if (value.kind === constants_js_1.OPENWAGGLE_EXTENSION.STORAGE.SCOPE.GLOBAL_KIND) {
+        return true;
+    }
+    return (value.kind === constants_js_1.OPENWAGGLE_EXTENSION.STORAGE.SCOPE.PROJECT_KIND &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.projectPath));
+}
+function isStorageKey(value) {
+    return ((0, internal_validation_js_1.isNonEmptyString)(value) &&
+        value === value.trim() &&
+        value.length <= constants_js_1.OPENWAGGLE_EXTENSION.STORAGE.KEY_MAX_LENGTH);
+}
+function hasStorageResultBase(value) {
+    return ((0, internal_validation_js_1.isNonEmptyString)(value.extensionId) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.contributionId) &&
+        value.capability === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STORAGE &&
+        isKnownString(constants_js_1.OPENWAGGLE_EXTENSION.STORAGE.KINDS, value.storageKind) &&
+        isStorageScope(value.storageScope));
+}
+function isStorageGetResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasStorageResultBase(value) &&
+        value.method === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.GET &&
+        isStorageKey(value.key) &&
+        (value.value === null || (0, internal_validation_js_1.isJsonValue)(value.value)));
+}
+function isStorageSetResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasStorageResultBase(value) &&
+        value.method === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.SET &&
+        isStorageKey(value.key) &&
+        (0, internal_validation_js_1.isJsonValue)(value.value) &&
+        typeof value.createdAt === 'number' &&
+        typeof value.updatedAt === 'number');
+}
+function isStorageDeleteResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasStorageResultBase(value) &&
+        value.method === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.DELETE &&
+        isStorageKey(value.key) &&
+        value.deleted === true);
+}
+function isStorageListResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasStorageResultBase(value) &&
+        value.method === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.LIST &&
+        (0, internal_validation_js_1.isStringArray)(value.keys) &&
+        value.keys.every(isStorageKey));
+}
+function hasRuntimeContributionResultBase(value) {
+    return ((0, internal_validation_js_1.isNonEmptyString)(value.extensionId) &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.contributionId) &&
+        value.capability === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.RUNTIME &&
+        isKnownString(constants_js_1.OPENWAGGLE_EXTENSION.CONTRIBUTION_FAMILIES, value.family));
+}
+function isRuntimeRegisterContributionResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasRuntimeContributionResultBase(value) &&
+        value.method === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.REGISTER_CONTRIBUTION &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.registeredContributionId));
+}
+function isRuntimeUnregisterContributionResult(value) {
+    return ((0, internal_validation_js_1.isRecord)(value) &&
+        hasRuntimeContributionResultBase(value) &&
+        value.method === constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.UNREGISTER_CONTRIBUTION &&
+        (0, internal_validation_js_1.isNonEmptyString)(value.unregisteredContributionId) &&
+        typeof value.unregistered === 'boolean');
+}

package/dist-cjs/broker.js

@@ -0,0 +1,120 @@
+"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.extensionInvokeResultSchema = exports.extensionInvokeFailureSchema = exports.extensionInvokeSuccessSchema = exports.extensionInvokeErrorSchema = exports.extensionInvokeInputSchema = exports.extensionCapabilityAuditEntrySchema = exports.extensionInvokeScopeSchema = void 0;
+exports.toInvokeInput = toInvokeInput;
+exports.createExtensionBrokerSdkFromInvoke = createExtensionBrokerSdkFromInvoke;
+exports.createExtensionBrokerSdk = createExtensionBrokerSdk;
+const Schema = __importStar(require("effect/Schema"));
+const constants_js_1 = require("./constants.js");
+const manifest_js_1 = require("./manifest.js");
+const openwaggle_sdk_js_1 = require("./openwaggle-sdk.js");
+const runtime_sdk_js_1 = require("./runtime-sdk.js");
+const storage_sdk_js_1 = require("./storage-sdk.js");
+const nonEmptyStringSchema = Schema.String.pipe(Schema.minLength(1));
+exports.extensionInvokeScopeSchema = Schema.Union(Schema.Struct({ kind: Schema.Literal('app') }), Schema.Struct({ kind: Schema.Literal('project'), projectPath: nonEmptyStringSchema }), Schema.Struct({
+    kind: Schema.Literal('session'),
+    projectPath: nonEmptyStringSchema,
+    sessionId: nonEmptyStringSchema,
+}), Schema.Struct({
+    kind: Schema.Literal('branch'),
+    projectPath: nonEmptyStringSchema,
+    sessionId: nonEmptyStringSchema,
+    branchId: nonEmptyStringSchema,
+}));
+exports.extensionCapabilityAuditEntrySchema = Schema.Struct({
+    extensionId: manifest_js_1.extensionIdSchema,
+    contributionId: manifest_js_1.extensionContributionIdSchema,
+    capability: manifest_js_1.extensionContributionIdSchema,
+    method: manifest_js_1.extensionContributionIdSchema,
+    scope: exports.extensionInvokeScopeSchema,
+    outcome: Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION_BROKER.OUTCOMES),
+    timestamp: Schema.Number,
+    failureCode: Schema.optional(Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION_BROKER.FAILURE_CODES)),
+});
+exports.extensionInvokeInputSchema = Schema.Struct({
+    extensionId: manifest_js_1.extensionIdSchema,
+    contributionId: manifest_js_1.extensionContributionIdSchema,
+    capability: manifest_js_1.extensionContributionIdSchema,
+    method: manifest_js_1.extensionContributionIdSchema,
+    scope: exports.extensionInvokeScopeSchema,
+    payload: Schema.optional(Schema.Unknown),
+});
+exports.extensionInvokeErrorSchema = Schema.Struct({
+    code: Schema.Literal(...constants_js_1.OPENWAGGLE_EXTENSION_BROKER.FAILURE_CODES),
+    message: nonEmptyStringSchema,
+    issues: Schema.optional(Schema.Array(Schema.String)),
+});
+exports.extensionInvokeSuccessSchema = Schema.Struct({
+    ok: Schema.Literal(true),
+    value: Schema.Unknown,
+    audit: exports.extensionCapabilityAuditEntrySchema,
+});
+exports.extensionInvokeFailureSchema = Schema.Struct({
+    ok: Schema.Literal(false),
+    error: exports.extensionInvokeErrorSchema,
+    audit: Schema.optional(exports.extensionCapabilityAuditEntrySchema),
+});
+exports.extensionInvokeResultSchema = Schema.Union(exports.extensionInvokeSuccessSchema, exports.extensionInvokeFailureSchema);
+function toInvokeInput(identity, request) {
+    return {
+        extensionId: identity.extensionId,
+        contributionId: identity.contributionId,
+        capability: request.capability,
+        method: request.method,
+        scope: request.scope,
+        ...(request.payload !== undefined ? { payload: request.payload } : {}),
+    };
+}
+function createExtensionBrokerSdkFromInvoke(invoke, options = {}) {
+    return {
+        invoke,
+        hostContext: {
+            getScope: (scope) => invoke({
+                capability: constants_js_1.OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.HOST_CONTEXT,
+                method: constants_js_1.OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_SCOPE,
+                scope,
+                payload: {},
+            }),
+        },
+        storage: (0, storage_sdk_js_1.createPackageStorageSdk)(invoke),
+        openWaggle: (0, openwaggle_sdk_js_1.createOpenWaggleSdk)(invoke, options),
+        runtime: (0, runtime_sdk_js_1.createRuntimeContributionSdk)(invoke),
+    };
+}
+function createExtensionBrokerSdk(transport, identity, options = {}) {
+    const invoke = (request) => transport(toInvokeInput(identity, request));
+    return createExtensionBrokerSdkFromInvoke(invoke, options);
+}

package/dist-cjs/constants.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPENWAGGLE_EXTENSION = exports.OPENWAGGLE_EXTENSION_BROKER = void 0;
+const TEN_MINUTES_MS = 10 * 60 * 1_000;
+const EXTENSION_BROKER_FAILURE_CODE = {
+    INVALID_INPUT: 'invalid-input',
+    INVALID_PAYLOAD: 'invalid-payload',
+    UNKNOWN_EXTENSION: 'unknown-extension',
+    DISABLED_EXTENSION: 'disabled-extension',
+    UNKNOWN_CONTRIBUTION: 'unknown-contribution',
+    UNDECLARED_CAPABILITY: 'undeclared-capability',
+    UNDECLARED_METHOD: 'undeclared-method',
+    UNDECLARED_SCOPE: 'undeclared-scope',
+    OUT_OF_SCOPE: 'out-of-scope',
+    UNSUPPORTED_CAPABILITY: 'unsupported-capability',
+    UNSUPPORTED_METHOD: 'unsupported-method',
+    TRANSPORT_FAILED: 'transport-failed',
+};
+const EXTENSION_BROKER_OUTCOME = {
+    SUCCEEDED: 'succeeded',
+    REJECTED: 'rejected',
+};
+const EXTENSION_BROKER_CAPABILITY = {
+    HOST_CONTEXT: 'openwaggle.host.context',
+    STORAGE: 'openwaggle.storage',
+    STATE: 'openwaggle.state',
+    ACTIONS: 'openwaggle.actions',
+    SETTINGS: 'openwaggle.settings',
+    DOCS: 'openwaggle.docs',
+    RUNTIME: 'openwaggle.runtime',
+};
+const EXTENSION_BROKER_METHOD = {
+    GET_SCOPE: 'get-scope',
+    GET: 'get',
+    SET: 'set',
+    DELETE: 'delete',
+    LIST: 'list',
+    GET_STATE: 'get-state',
+    READ_STATE: 'read-state',
+    SELECT_PROJECT: 'select-project',
+    GET_SETTINGS: 'get-settings',
+    UPDATE_SETTINGS: 'update-settings',
+    GET_SETTING: 'get-setting',
+    UPDATE_SETTING: 'update-setting',
+    DISCOVER_DOCS: 'discover-docs',
+    RESOLVE_DOCS_TOPIC: 'resolve-docs-topic',
+    REGISTER_CONTRIBUTION: 'register-contribution',
+    UNREGISTER_CONTRIBUTION: 'unregister-contribution',
+};
+const EXTENSION_BROKER_STATE_SELECTOR = {
+    CURRENT_PROJECT: 'current-project',
+    CURRENT_SESSION: 'current-session',
+    CURRENT_BRANCH: 'current-branch',
+    RECENT_PROJECTS: 'recent-projects',
+    MODEL_PREFERENCES: 'model-preferences',
+};
+const EXTENSION_BROKER_SETTING_KEY = {
+    MODEL_PREFERENCES: 'model-preferences',
+    PROJECT_DISPLAY_NAME: 'project-display-name',
+};
+const EXTENSION_BROKER_CAPABILITY_METHODS = [
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.HOST_CONTEXT,
+        methods: [EXTENSION_BROKER_METHOD.GET_SCOPE],
+    },
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.STORAGE,
+        methods: [
+            EXTENSION_BROKER_METHOD.GET,
+            EXTENSION_BROKER_METHOD.SET,
+            EXTENSION_BROKER_METHOD.DELETE,
+            EXTENSION_BROKER_METHOD.LIST,
+        ],
+    },
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.STATE,
+        methods: [EXTENSION_BROKER_METHOD.GET_STATE, EXTENSION_BROKER_METHOD.READ_STATE],
+    },
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.ACTIONS,
+        methods: [EXTENSION_BROKER_METHOD.SELECT_PROJECT],
+    },
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.SETTINGS,
+        methods: [
+            EXTENSION_BROKER_METHOD.GET_SETTINGS,
+            EXTENSION_BROKER_METHOD.UPDATE_SETTINGS,
+            EXTENSION_BROKER_METHOD.GET_SETTING,
+            EXTENSION_BROKER_METHOD.UPDATE_SETTING,
+        ],
+    },
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.DOCS,
+        methods: [EXTENSION_BROKER_METHOD.DISCOVER_DOCS, EXTENSION_BROKER_METHOD.RESOLVE_DOCS_TOPIC],
+    },
+    {
+        capability: EXTENSION_BROKER_CAPABILITY.RUNTIME,
+        methods: [
+            EXTENSION_BROKER_METHOD.REGISTER_CONTRIBUTION,
+            EXTENSION_BROKER_METHOD.UNREGISTER_CONTRIBUTION,
+        ],
+    },
+];
+const EXTENSION_CONTRIBUTION_FAMILY = {
+    COMMANDS: 'commands',
+    SLASH_COMMANDS: 'slashCommands',
+    ROUTES: 'routes',
+    SETTINGS_SECTIONS: 'settingsSections',
+    SIDE_PANELS: 'sidePanels',
+    DIALOGS: 'dialogs',
+    TRANSCRIPT_RENDERERS: 'transcriptRenderers',
+    TOOL_RENDERERS: 'toolRenderers',
+    CUSTOM_MESSAGE_RENDERERS: 'customMessageRenderers',
+    INTERACTION_RENDERERS: 'interactionRenderers',
+    STATUS_WIDGETS: 'statusWidgets',
+};
+const EXTENSION_COMMAND_CONTRIBUTION_FAMILIES = Object.freeze([
+    EXTENSION_CONTRIBUTION_FAMILY.COMMANDS,
+    EXTENSION_CONTRIBUTION_FAMILY.SLASH_COMMANDS,
+]);
+const EXTENSION_SLOT_CONTRIBUTION_FAMILIES = Object.freeze([
+    EXTENSION_CONTRIBUTION_FAMILY.SETTINGS_SECTIONS,
+    EXTENSION_CONTRIBUTION_FAMILY.SIDE_PANELS,
+    EXTENSION_CONTRIBUTION_FAMILY.DIALOGS,
+    EXTENSION_CONTRIBUTION_FAMILY.TRANSCRIPT_RENDERERS,
+    EXTENSION_CONTRIBUTION_FAMILY.TOOL_RENDERERS,
+    EXTENSION_CONTRIBUTION_FAMILY.CUSTOM_MESSAGE_RENDERERS,
+    EXTENSION_CONTRIBUTION_FAMILY.INTERACTION_RENDERERS,
+    EXTENSION_CONTRIBUTION_FAMILY.STATUS_WIDGETS,
+]);
+const EXTENSION_ENTRY_CONTRIBUTION_FAMILIES = Object.freeze([
+    EXTENSION_CONTRIBUTION_FAMILY.ROUTES,
+    ...EXTENSION_SLOT_CONTRIBUTION_FAMILIES,
+]);
+const EXTENSION_CONTRIBUTION_FAMILIES = Object.freeze([
+    ...EXTENSION_COMMAND_CONTRIBUTION_FAMILIES,
+    ...EXTENSION_ENTRY_CONTRIBUTION_FAMILIES,
+]);
+const EXTENSION_CONTRIBUTION_RUNTIME = {
+    FEDERATED_MODULE: 'federated-module',
+    TRUSTED_RENDERER: 'trusted-renderer',
+};
+const EXTENSION_EXECUTION_PLACEMENT = {
+    HOST_RENDERER: 'host-renderer',
+    FRAME: 'frame',
+};
+const EXTENSION_STORAGE_KIND = {
+    STATE: 'state',
+    CONFIG: 'config',
+};
+const EXTENSION_STORAGE_SCOPE = {
+    GLOBAL_KIND: 'global',
+    PROJECT_KIND: 'project',
+    GLOBAL_ID: 'global',
+};
+const EXTENSION_INSTALL_SOURCE = {
+    PREBUILT: 'prebuilt',
+    LOCAL_BUILD: 'local-build',
+};
+const EXTENSION_RUNTIME_REQUIREMENT_TYPE = {
+    BINARY: 'binary',
+    COMMAND: 'command',
+};
+const EXTENSION_NETWORK_ACCESS_MODE = {
+    BROKERED: 'brokered',
+    RESTRICTED: 'restricted',
+    DIRECT: 'direct',
+};
+exports.OPENWAGGLE_EXTENSION_BROKER = {
+    CAPABILITY: EXTENSION_BROKER_CAPABILITY,
+    CAPABILITIES: Object.freeze(Object.values(EXTENSION_BROKER_CAPABILITY)),
+    CAPABILITY_METHODS: EXTENSION_BROKER_CAPABILITY_METHODS,
+    METHOD: EXTENSION_BROKER_METHOD,
+    METHODS: Object.freeze(Object.values(EXTENSION_BROKER_METHOD)),
+    FAILURE_CODE: EXTENSION_BROKER_FAILURE_CODE,
+    FAILURE_CODES: Object.freeze(Object.values(EXTENSION_BROKER_FAILURE_CODE)),
+    OUTCOME: EXTENSION_BROKER_OUTCOME,
+    OUTCOMES: Object.freeze(Object.values(EXTENSION_BROKER_OUTCOME)),
+    STATE_SELECTOR: EXTENSION_BROKER_STATE_SELECTOR,
+    STATE_SELECTORS: Object.freeze(Object.values(EXTENSION_BROKER_STATE_SELECTOR)),
+    SETTING_KEY: EXTENSION_BROKER_SETTING_KEY,
+    SETTING_KEYS: Object.freeze(Object.values(EXTENSION_BROKER_SETTING_KEY)),
+};
+exports.OPENWAGGLE_EXTENSION = {
+    MANIFEST_FILE: 'openwaggle.extension.json',
+    SDK_VERSION: '0.1.0',
+    PROJECT_ROOT_SEGMENTS: ['.openwaggle', 'extensions'],
+    GLOBAL_EXTENSIONS_DIR: 'extensions',
+    SCOPE: {
+        GLOBAL_KIND: 'global',
+        PROJECT_KIND: 'project',
+        GLOBAL_ID: 'global',
+    },
+    LIMITS: {
+        ID_MAX_LENGTH: 96,
+        CONTRIBUTION_ID_MAX_LENGTH: 128,
+        NAME_MAX_LENGTH: 120,
+        DESCRIPTION_MAX_LENGTH: 2_000,
+        RELATIVE_PATH_MAX_LENGTH: 260,
+        NETWORK_ORIGIN_MAX_LENGTH: 300,
+        RUNTIME_REQUIREMENT_BINARY_MAX_LENGTH: 120,
+        BUILD_COMMAND_MAX_LENGTH: 500,
+        BUILD_LOG_MAX_LENGTH: 4_000,
+        BUILD_COMMAND_TIMEOUT_MS: TEN_MINUTES_MS,
+    },
+    PATTERNS: {
+        WINDOWS_ABSOLUTE_PATH: /^[A-Za-z]:[\\/]/,
+        ID: /^[a-z0-9][a-z0-9._-]*$/,
+        CONTRIBUTION_ID: /^[a-z0-9][a-z0-9._/-]*$/,
+        SEMVER_VERSION: /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/,
+    },
+    PATH: {
+        NUL_CHARACTER: '\0',
+        POSIX_SEPARATOR: '/',
+        WINDOWS_SEPARATOR: '\\',
+        RELATIVE_PARENT_SEGMENT: '..',
+        CURRENT_DIRECTORY_SEGMENT: '.',
+    },
+    RUNTIME_MODULE_PROTOCOL: {
+        MODULE_CONTEXT_SEGMENT: '__context__',
+    },
+    CAPABILITY_SCOPES: ['app', 'project', 'session', 'branch'],
+    CONTRIBUTION_FAMILY: EXTENSION_CONTRIBUTION_FAMILY,
+    CONTRIBUTION_FAMILIES: EXTENSION_CONTRIBUTION_FAMILIES,
+    COMMAND_CONTRIBUTION_FAMILIES: EXTENSION_COMMAND_CONTRIBUTION_FAMILIES,
+    CONTRIBUTION_RUNTIME: EXTENSION_CONTRIBUTION_RUNTIME,
+    CONTRIBUTION_RUNTIMES: Object.freeze(Object.values(EXTENSION_CONTRIBUTION_RUNTIME)),
+    EXECUTION_PLACEMENT: EXTENSION_EXECUTION_PLACEMENT,
+    EXECUTION_PLACEMENTS: Object.freeze(Object.values(EXTENSION_EXECUTION_PLACEMENT)),
+    STORAGE: {
+        KIND: EXTENSION_STORAGE_KIND,
+        KINDS: Object.freeze(Object.values(EXTENSION_STORAGE_KIND)),
+        SCOPE: EXTENSION_STORAGE_SCOPE,
+        SCOPE_KINDS: Object.freeze([
+            EXTENSION_STORAGE_SCOPE.GLOBAL_KIND,
+            EXTENSION_STORAGE_SCOPE.PROJECT_KIND,
+        ]),
+        KEY_MAX_LENGTH: 160,
+    },
+    ENTRY_CONTRIBUTION_FAMILIES: EXTENSION_ENTRY_CONTRIBUTION_FAMILIES,
+    SLOT_CONTRIBUTION_FAMILIES: EXTENSION_SLOT_CONTRIBUTION_FAMILIES,
+    INSTALL_SOURCE: EXTENSION_INSTALL_SOURCE,
+    INSTALL_SOURCES: Object.freeze(Object.values(EXTENSION_INSTALL_SOURCE)),
+    RUNTIME_REQUIREMENT_TYPE: EXTENSION_RUNTIME_REQUIREMENT_TYPE,
+    RUNTIME_REQUIREMENT_TYPES: Object.freeze(Object.values(EXTENSION_RUNTIME_REQUIREMENT_TYPE)),
+    NETWORK_ACCESS_MODE: EXTENSION_NETWORK_ACCESS_MODE,
+    NETWORK_ACCESS_MODES: Object.freeze(Object.values(EXTENSION_NETWORK_ACCESS_MODE)),
+};

package/dist-cjs/context.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNoopExtensionSurfaceSdk = createNoopExtensionSurfaceSdk;
+exports.createOpenWaggleExtensionSharedModules = createOpenWaggleExtensionSharedModules;
+exports.createOpenWaggleExtensionSurfaceContext = createOpenWaggleExtensionSurfaceContext;
+const constants_js_1 = require("./constants.js");
+const theme_js_1 = require("./theme.js");
+const ui_js_1 = require("./ui.js");
+function createNoopExtensionSurfaceSdk() {
+    return {
+        sendAction: async () => undefined,
+        respondInteraction: async () => undefined,
+    };
+}
+function createOpenWaggleExtensionSharedModules(theme = (0, theme_js_1.createOpenWaggleExtensionTheme)()) {
+    return {
+        sdk: {
+            openWaggleVersion: constants_js_1.OPENWAGGLE_EXTENSION.SDK_VERSION,
+        },
+        theme: {
+            current: theme,
+            createTheme: theme_js_1.createOpenWaggleExtensionTheme,
+            cssVariableEntries: theme_js_1.extensionThemeCssVariableEntries,
+        },
+        ui: {
+            classNames: ui_js_1.OPENWAGGLE_EXTENSION_UI_CLASS_NAMES,
+            attributes: ui_js_1.OPENWAGGLE_EXTENSION_UI_ATTRIBUTES,
+            className: ui_js_1.openWaggleExtensionClassName,
+            createStylesheet: ui_js_1.createOpenWaggleExtensionUiStylesheet,
+        },
+    };
+}
+function createOpenWaggleExtensionSurfaceContext(input) {
+    return {
+        extension: {
+            id: input.entry.extensionId,
+            name: input.entry.extensionName,
+            version: input.entry.extensionVersion,
+        },
+        contribution: {
+            id: input.entry.contributionId,
+            title: input.entry.title,
+            family: input.entry.family,
+        },
+        surface: {
+            family: input.entry.family,
+            execution: input.entry.execution ?? '',
+            ...(input.surfacePayload !== undefined ? { payload: input.surfacePayload } : {}),
+        },
+        packagePath: input.entry.packagePath,
+        projectPaths: input.entry.projectPaths,
+        theme: input.theme ?? (0, theme_js_1.createOpenWaggleExtensionTheme)(),
+    };
+}

package/dist-cjs/contribution-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/core-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });