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

package/dist/manifest.d.ts

@@ -0,0 +1,303 @@
+import * as Schema from 'effect/Schema';
+import { OPENWAGGLE_EXTENSION } from './constants.js';
+import { type SchemaType } from './schema.js';
+export * from './manifest-contributions.js';
+export { extensionCapabilityScopeSchema, extensionCommandContributionFamilySchema, extensionContributionFamilySchema, extensionContributionIdSchema, extensionContributionRuntimeSchema, extensionExecutionPlacementSchema, extensionIdSchema, extensionRelativePathSchema, extensionSemverVersionSchema, extensionSlotContributionFamilySchema, } from './manifest-primitives.js';
+export declare const extensionRuntimeRequirementTypeSchema: Schema.SchemaClass<"binary" | "command", "binary" | "command", never>;
+export declare const extensionRuntimeRequirementSchema: Schema.filter<Schema.Struct<{
+    id: Schema.filter<Schema.filter<typeof Schema.String>>;
+    label: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    kind: Schema.optional<Schema.SchemaClass<"binary" | "command", "binary" | "command", never>>;
+    command: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    binary: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+}>>;
+export declare const extensionInstallSourceSchema: Schema.SchemaClass<"prebuilt" | "local-build", "prebuilt" | "local-build", never>;
+export declare const extensionInstallSchema: Schema.Struct<{
+    source: Schema.SchemaClass<"prebuilt" | "local-build", "prebuilt" | "local-build", never>;
+}>;
+export declare const extensionBuildSchema: Schema.Struct<{
+    command: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    outputs: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+}>;
+export declare const extensionNetworkSchema: Schema.Struct<{
+    origins: Schema.Array$<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+}>;
+export declare const extensionDocsTopicDeclarationSchema: Schema.Struct<{
+    id: Schema.filter<Schema.filter<typeof Schema.String>>;
+    title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    path: Schema.filter<Schema.filter<typeof Schema.String>>;
+    description: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    aliases: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    keywords: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+}>;
+export declare const extensionDocsSchema: Schema.Struct<{
+    topics: Schema.optional<Schema.Array$<Schema.Struct<{
+        id: Schema.filter<Schema.filter<typeof Schema.String>>;
+        title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        path: Schema.filter<Schema.filter<typeof Schema.String>>;
+        description: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+        aliases: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+        keywords: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    }>>>;
+}>;
+export declare const openWaggleExtensionManifestSchema: Schema.filter<Schema.Struct<{
+    manifestVersion: Schema.Literal<[1]>;
+    id: Schema.filter<Schema.filter<typeof Schema.String>>;
+    name: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    version: Schema.filter<Schema.filter<typeof Schema.String>>;
+    description: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    sdk: Schema.Struct<{
+        openwaggle: Schema.filter<Schema.filter<typeof Schema.String>>;
+    }>;
+    sourceFiles: Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    builtArtifacts: Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    install: Schema.optional<Schema.Struct<{
+        source: Schema.SchemaClass<"prebuilt" | "local-build", "prebuilt" | "local-build", never>;
+    }>>;
+    build: Schema.optional<Schema.Struct<{
+        command: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        outputs: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    }>>;
+    docs: Schema.optional<Schema.Struct<{
+        topics: Schema.optional<Schema.Array$<Schema.Struct<{
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            path: Schema.filter<Schema.filter<typeof Schema.String>>;
+            description: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            aliases: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            keywords: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+        }>>>;
+    }>>;
+    network: Schema.optional<Schema.Struct<{
+        origins: Schema.Array$<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    }>>;
+    capabilities: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+        id: Schema.filter<Schema.filter<typeof Schema.String>>;
+        methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+        scopes: Schema.optional<Schema.Array$<Schema.Literal<["app", "project", "session", "branch"]>>>;
+    }>>>>;
+    contributions: Schema.optional<Schema.Struct<{
+        commands: Schema.optional<Schema.Array$<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            category: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>;
+        slashCommands: Schema.optional<Schema.Array$<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            category: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>;
+        routes: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        settingsSections: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        sidePanels: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        dialogs: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        transcriptRenderers: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        toolRenderers: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        customMessageRenderers: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        interactionRenderers: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+        statusWidgets: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+            capability: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            method: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            methods: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            id: Schema.filter<Schema.filter<typeof Schema.String>>;
+            title: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            runtime: Schema.SchemaClass<"federated-module" | "trusted-renderer", "federated-module" | "trusted-renderer", never>;
+            execution: Schema.SchemaClass<"host-renderer" | "frame", "host-renderer" | "frame", never>;
+            entry: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            target: Schema.optional<Schema.Struct<{
+                projectPaths: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                sessionIds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+            matches: Schema.optional<Schema.Struct<{
+                toolNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                customMessageNames: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+                interactionKinds: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+            }>>;
+        }>>>>;
+    }>>;
+    pi: Schema.optional<Schema.Struct<{
+        resourceRoots: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    }>>;
+    trusted: Schema.optional<Schema.Struct<{
+        main: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        renderer: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    }>>;
+    runtimeRequirements: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+        id: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        kind: Schema.optional<Schema.SchemaClass<"binary" | "command", "binary" | "command", never>>;
+        command: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        binary: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+    }>>>>;
+}>>;
+export type ExtensionRuntimeRequirementDeclaration = SchemaType<typeof extensionRuntimeRequirementSchema>;
+export type ExtensionDocsTopicDeclaration = SchemaType<typeof extensionDocsTopicDeclarationSchema>;
+export type OpenWaggleExtensionManifest = SchemaType<typeof openWaggleExtensionManifestSchema>;
+export type OpenWaggleExtensionManifestFile = typeof OPENWAGGLE_EXTENSION.MANIFEST_FILE;
+export type ExtensionManifestValidationResult = {
+    readonly success: true;
+    readonly manifest: OpenWaggleExtensionManifest;
+} | {
+    readonly success: false;
+    readonly issues: readonly string[];
+};
+export declare function defineExtensionManifest<const TManifest extends OpenWaggleExtensionManifest>(manifest: TManifest): TManifest;
+export declare function validateExtensionManifest(value: unknown): ExtensionManifestValidationResult;

package/dist/manifest.js

@@ -0,0 +1,89 @@
+import * as Schema from 'effect/Schema';
+import { OPENWAGGLE_EXTENSION } from './constants.js';
+import { extensionCapabilityDeclarationSchema, extensionContributionsSchema, } from './manifest-contributions.js';
+import { extensionContributionIdSchema, extensionIdSchema, extensionNonEmptyStringSchema, extensionRelativePathSchema, extensionSemverVersionSchema, isBuildCommand, isNetworkOrigin, isRuntimeRequirementBinary, } from './manifest-primitives.js';
+import { safeDecodeExtensionSchema } from './schema.js';
+export * from './manifest-contributions.js';
+export { extensionCapabilityScopeSchema, extensionCommandContributionFamilySchema, extensionContributionFamilySchema, extensionContributionIdSchema, extensionContributionRuntimeSchema, extensionExecutionPlacementSchema, extensionIdSchema, extensionRelativePathSchema, extensionSemverVersionSchema, extensionSlotContributionFamilySchema, } from './manifest-primitives.js';
+export const extensionRuntimeRequirementTypeSchema = Schema.Literal(...OPENWAGGLE_EXTENSION.RUNTIME_REQUIREMENT_TYPES);
+export const extensionRuntimeRequirementSchema = Schema.Struct({
+    id: extensionContributionIdSchema,
+    label: extensionNonEmptyStringSchema.pipe(Schema.maxLength(OPENWAGGLE_EXTENSION.LIMITS.NAME_MAX_LENGTH)),
+    kind: Schema.optional(extensionRuntimeRequirementTypeSchema),
+    command: Schema.optional(extensionRelativePathSchema),
+    binary: Schema.optional(extensionNonEmptyStringSchema.pipe(Schema.filter(isRuntimeRequirementBinary))),
+}).pipe(Schema.filter((requirement) => {
+    const hasBinary = requirement.binary !== undefined;
+    const hasCommand = requirement.command !== undefined;
+    if (hasBinary === hasCommand) {
+        return 'Declare exactly one runtime requirement target: binary or command.';
+    }
+    if (hasBinary &&
+        requirement.kind !== undefined &&
+        requirement.kind !== OPENWAGGLE_EXTENSION.RUNTIME_REQUIREMENT_TYPE.BINARY) {
+        return 'Runtime requirement kind must be "binary" when binary is declared.';
+    }
+    if (hasCommand &&
+        requirement.kind !== undefined &&
+        requirement.kind !== OPENWAGGLE_EXTENSION.RUNTIME_REQUIREMENT_TYPE.COMMAND) {
+        return 'Runtime requirement kind must be "command" when command is declared.';
+    }
+    return true;
+}));
+export const extensionInstallSourceSchema = Schema.Literal(...OPENWAGGLE_EXTENSION.INSTALL_SOURCES);
+export const extensionInstallSchema = Schema.Struct({ source: extensionInstallSourceSchema });
+export const extensionBuildSchema = Schema.Struct({
+    command: extensionNonEmptyStringSchema.pipe(Schema.filter(isBuildCommand)),
+    outputs: Schema.optional(Schema.Array(extensionRelativePathSchema)),
+});
+export const extensionNetworkSchema = Schema.Struct({
+    origins: Schema.Array(extensionNonEmptyStringSchema.pipe(Schema.filter(isNetworkOrigin))),
+});
+export const extensionDocsTopicDeclarationSchema = Schema.Struct({
+    id: extensionContributionIdSchema,
+    title: extensionNonEmptyStringSchema.pipe(Schema.maxLength(OPENWAGGLE_EXTENSION.LIMITS.NAME_MAX_LENGTH)),
+    path: extensionRelativePathSchema,
+    description: Schema.optional(extensionNonEmptyStringSchema.pipe(Schema.maxLength(OPENWAGGLE_EXTENSION.LIMITS.DESCRIPTION_MAX_LENGTH))),
+    aliases: Schema.optional(Schema.Array(extensionNonEmptyStringSchema)),
+    keywords: Schema.optional(Schema.Array(extensionNonEmptyStringSchema)),
+});
+export const extensionDocsSchema = Schema.Struct({
+    topics: Schema.optional(Schema.Array(extensionDocsTopicDeclarationSchema)),
+});
+function validateTrustedRendererRuntimeBoundary(manifest) {
+    const usesTrustedRenderer = OPENWAGGLE_EXTENSION.ENTRY_CONTRIBUTION_FAMILIES.some((family) => manifest.contributions?.[family]?.some((contribution) => contribution.runtime === OPENWAGGLE_EXTENSION.CONTRIBUTION_RUNTIME.TRUSTED_RENDERER));
+    return (!usesTrustedRenderer ||
+        manifest.trusted?.renderer !== undefined ||
+        'Trusted renderer contributions require trusted.renderer to declare privileged renderer runtime execution.');
+}
+export const openWaggleExtensionManifestSchema = Schema.Struct({
+    manifestVersion: Schema.Literal(1),
+    id: extensionIdSchema,
+    name: extensionNonEmptyStringSchema.pipe(Schema.maxLength(OPENWAGGLE_EXTENSION.LIMITS.NAME_MAX_LENGTH)),
+    version: extensionSemverVersionSchema,
+    description: Schema.optional(extensionNonEmptyStringSchema.pipe(Schema.maxLength(OPENWAGGLE_EXTENSION.LIMITS.DESCRIPTION_MAX_LENGTH))),
+    sdk: Schema.Struct({ openwaggle: extensionNonEmptyStringSchema }),
+    sourceFiles: Schema.Array(extensionRelativePathSchema),
+    builtArtifacts: Schema.Array(extensionRelativePathSchema),
+    install: Schema.optional(extensionInstallSchema),
+    build: Schema.optional(extensionBuildSchema),
+    docs: Schema.optional(extensionDocsSchema),
+    network: Schema.optional(extensionNetworkSchema),
+    capabilities: Schema.optional(Schema.Array(extensionCapabilityDeclarationSchema)),
+    contributions: Schema.optional(extensionContributionsSchema),
+    pi: Schema.optional(Schema.Struct({ resourceRoots: Schema.optional(Schema.Array(extensionRelativePathSchema)) })),
+    trusted: Schema.optional(Schema.Struct({
+        main: Schema.optional(extensionRelativePathSchema),
+        renderer: Schema.optional(extensionRelativePathSchema),
+    })),
+    runtimeRequirements: Schema.optional(Schema.Array(extensionRuntimeRequirementSchema)),
+}).pipe(Schema.filter(validateTrustedRendererRuntimeBoundary));
+export function defineExtensionManifest(manifest) {
+    return manifest;
+}
+export function validateExtensionManifest(value) {
+    const result = safeDecodeExtensionSchema(openWaggleExtensionManifestSchema, value);
+    return result.success
+        ? { success: true, manifest: result.data }
+        : { success: false, issues: result.issues };
+}

package/dist/openwaggle-sdk.d.ts

@@ -0,0 +1,2 @@
+import type { CreateOpenWaggleSdkOptions, ExtensionOpenWaggleSdk, ExtensionSdkInvoke } from './sdk-types.js';
+export declare function createOpenWaggleSdk(invoke: ExtensionSdkInvoke, options?: CreateOpenWaggleSdkOptions): ExtensionOpenWaggleSdk;

package/dist/openwaggle-sdk.js

@@ -0,0 +1,127 @@
+import { toDecodedOperationResult } from './broker-validation.js';
+import { OPENWAGGLE_EXTENSION_BROKER } from './constants.js';
+import { isDocsDiscoverResult, isDocsResolveTopicResult } from './docs-validation.js';
+import { isActionSelectProjectResult, isSettingsGetResult, isSettingsGetSettingResult, isSettingsUpdateResult, isSettingsUpdateSettingResult, isStateCurrentBranchReadResult, isStateCurrentProjectReadResult, isStateCurrentSessionReadResult, isStateModelPreferencesReadResult, isStateReadResult, isStateRecentProjectsReadResult, } from './openwaggle-validation.js';
+const ACTION_RESULT_ERROR = 'Extension broker returned an invalid OpenWaggle action result.';
+const DOCS_RESULT_ERROR = 'Extension broker returned an invalid OpenWaggle docs result.';
+const SETTINGS_RESULT_ERROR = 'Extension broker returned an invalid OpenWaggle settings result.';
+const STATE_RESULT_ERROR = 'Extension broker returned an invalid OpenWaggle state result.';
+const unsupportedOpenExternal = async () => {
+    throw new Error('OpenWaggle external URL action is not available in this extension host context.');
+};
+function createOpenWaggleStateSdk(invoke) {
+    return {
+        get: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_STATE,
+            scope,
+            payload: {},
+        }), isStateReadResult, STATE_RESULT_ERROR),
+        readCurrentProject: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.READ_STATE,
+            scope,
+            payload: { selector: OPENWAGGLE_EXTENSION_BROKER.STATE_SELECTOR.CURRENT_PROJECT },
+        }), isStateCurrentProjectReadResult, STATE_RESULT_ERROR),
+        readCurrentSession: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.READ_STATE,
+            scope,
+            payload: { selector: OPENWAGGLE_EXTENSION_BROKER.STATE_SELECTOR.CURRENT_SESSION },
+        }), isStateCurrentSessionReadResult, STATE_RESULT_ERROR),
+        readCurrentBranch: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.READ_STATE,
+            scope,
+            payload: { selector: OPENWAGGLE_EXTENSION_BROKER.STATE_SELECTOR.CURRENT_BRANCH },
+        }), isStateCurrentBranchReadResult, STATE_RESULT_ERROR),
+        readRecentProjects: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.READ_STATE,
+            scope,
+            payload: { selector: OPENWAGGLE_EXTENSION_BROKER.STATE_SELECTOR.RECENT_PROJECTS },
+        }), isStateRecentProjectsReadResult, STATE_RESULT_ERROR),
+        readModelPreferences: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.READ_STATE,
+            scope,
+            payload: { selector: OPENWAGGLE_EXTENSION_BROKER.STATE_SELECTOR.MODEL_PREFERENCES },
+        }), isStateModelPreferencesReadResult, STATE_RESULT_ERROR),
+    };
+}
+function createOpenWaggleSettingsSdk(invoke) {
+    return {
+        get: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_SETTINGS,
+            scope,
+            payload: {},
+        }), isSettingsGetResult, SETTINGS_RESULT_ERROR),
+        getModelPreferences: async (scope) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_SETTING,
+            scope,
+            payload: { key: OPENWAGGLE_EXTENSION_BROKER.SETTING_KEY.MODEL_PREFERENCES },
+        }), isSettingsGetSettingResult, SETTINGS_RESULT_ERROR),
+        updateModelPreferences: async (scope, value) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.UPDATE_SETTING,
+            scope,
+            payload: { key: OPENWAGGLE_EXTENSION_BROKER.SETTING_KEY.MODEL_PREFERENCES, value },
+        }), isSettingsUpdateSettingResult, SETTINGS_RESULT_ERROR),
+        getProjectDisplayName: async (scope, projectPath) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_SETTING,
+            scope,
+            payload: {
+                key: OPENWAGGLE_EXTENSION_BROKER.SETTING_KEY.PROJECT_DISPLAY_NAME,
+                projectPath,
+            },
+        }), isSettingsGetSettingResult, SETTINGS_RESULT_ERROR),
+        setProjectDisplayName: async (scope, projectPath, value) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.UPDATE_SETTING,
+            scope,
+            payload: {
+                key: OPENWAGGLE_EXTENSION_BROKER.SETTING_KEY.PROJECT_DISPLAY_NAME,
+                projectPath,
+                value,
+            },
+        }), isSettingsUpdateSettingResult, SETTINGS_RESULT_ERROR),
+        update: async (scope, settings) => toDecodedOperationResult(await invoke({
+            capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS,
+            method: OPENWAGGLE_EXTENSION_BROKER.METHOD.UPDATE_SETTINGS,
+            scope,
+            payload: settings,
+        }), isSettingsUpdateResult, SETTINGS_RESULT_ERROR),
+    };
+}
+export function createOpenWaggleSdk(invoke, options = {}) {
+    return {
+        state: createOpenWaggleStateSdk(invoke),
+        actions: {
+            openExternal: options.openExternal ?? unsupportedOpenExternal,
+            selectProject: async (scope, projectPath) => toDecodedOperationResult(await invoke({
+                capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.ACTIONS,
+                method: OPENWAGGLE_EXTENSION_BROKER.METHOD.SELECT_PROJECT,
+                scope,
+                payload: { projectPath },
+            }), isActionSelectProjectResult, ACTION_RESULT_ERROR),
+        },
+        settings: createOpenWaggleSettingsSdk(invoke),
+        docs: {
+            discover: async (scope, input = {}) => toDecodedOperationResult(await invoke({
+                capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.DOCS,
+                method: OPENWAGGLE_EXTENSION_BROKER.METHOD.DISCOVER_DOCS,
+                scope,
+                payload: input,
+            }), isDocsDiscoverResult, DOCS_RESULT_ERROR),
+            resolveTopic: async (scope, input) => toDecodedOperationResult(await invoke({
+                capability: OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.DOCS,
+                method: OPENWAGGLE_EXTENSION_BROKER.METHOD.RESOLVE_DOCS_TOPIC,
+                scope,
+                payload: input,
+            }), isDocsResolveTopicResult, DOCS_RESULT_ERROR),
+        },
+    };
+}

package/dist/openwaggle-types.d.ts

@@ -0,0 +1,111 @@
+import type { OPENWAGGLE_EXTENSION_BROKER } from './constants.js';
+import type { ExtensionInvokeScope, ExtensionStateSelector } from './core-types.js';
+export type { ExtensionDocsDiscoverPayload, ExtensionDocsDiscoverResult, ExtensionDocsResolveTopicPayload, ExtensionDocsResolveTopicResult, } from './docs.js';
+export interface ExtensionModelPrefs {
+    readonly selectedModel: string;
+    readonly favoriteModels: readonly string[];
+    readonly enabledModels: readonly string[];
+    readonly thinkingLevel: string;
+}
+export interface ExtensionProjectView {
+    readonly projectPath: string;
+    readonly displayName: string | null;
+    readonly active: boolean;
+}
+export interface ExtensionSessionView {
+    readonly sessionId: string;
+    readonly title: string;
+    readonly projectPath: string | null;
+}
+export interface ExtensionBranchView {
+    readonly branchId: string;
+    readonly sessionId: string;
+    readonly name: string;
+    readonly main: boolean;
+    readonly archived: boolean;
+}
+export interface ExtensionStateReadResult {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_STATE;
+    readonly scope: ExtensionInvokeScope;
+    readonly activeProjectPath: string | null;
+    readonly currentProject: ExtensionProjectView | null;
+    readonly currentSession: ExtensionSessionView | null;
+    readonly currentBranch: ExtensionBranchView | null;
+    readonly recentProjects: readonly string[];
+    readonly modelPreferences: ExtensionModelPrefs;
+}
+export interface ExtensionSelectedStateReadResult<TValue> {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.STATE;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.READ_STATE;
+    readonly scope: ExtensionInvokeScope;
+    readonly selector: ExtensionStateSelector;
+    readonly value: TValue;
+}
+export type ExtensionStateCurrentProjectReadResult = ExtensionSelectedStateReadResult<ExtensionProjectView | null>;
+export type ExtensionStateCurrentSessionReadResult = ExtensionSelectedStateReadResult<ExtensionSessionView | null>;
+export type ExtensionStateCurrentBranchReadResult = ExtensionSelectedStateReadResult<ExtensionBranchView | null>;
+export type ExtensionStateRecentProjectsReadResult = ExtensionSelectedStateReadResult<readonly string[]>;
+export type ExtensionStateModelPreferencesReadResult = ExtensionSelectedStateReadResult<ExtensionModelPrefs>;
+export interface ExtensionActionSelectProjectResult {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.ACTIONS;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.SELECT_PROJECT;
+    readonly previousProjectPath: string | null;
+    readonly projectPath: string;
+    readonly recentProjects: readonly string[];
+}
+export interface ExtensionSettingsView {
+    readonly modelPreferences: ExtensionModelPrefs;
+    readonly projectDisplayNames: Readonly<Record<string, string>>;
+}
+export interface ExtensionModelPreferencesSettingsPatch {
+    readonly selectedModel?: string;
+    readonly favoriteModels?: readonly string[];
+    readonly enabledModels?: readonly string[];
+    readonly thinkingLevel?: string;
+}
+export type ExtensionSettingsUpdatePayload = ExtensionModelPreferencesSettingsPatch & {
+    readonly projectDisplayNames?: Readonly<Record<string, string>>;
+};
+export interface ExtensionSettingsGetResult {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_SETTINGS;
+    readonly settings: ExtensionSettingsView;
+}
+export interface ExtensionSettingsUpdateResult {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.UPDATE_SETTINGS;
+    readonly settings: ExtensionSettingsView;
+}
+export type ExtensionSettingsSelectedValue = {
+    readonly key: typeof OPENWAGGLE_EXTENSION_BROKER.SETTING_KEY.MODEL_PREFERENCES;
+    readonly value: ExtensionModelPrefs;
+} | {
+    readonly key: typeof OPENWAGGLE_EXTENSION_BROKER.SETTING_KEY.PROJECT_DISPLAY_NAME;
+    readonly projectPath: string;
+    readonly value: string | null;
+};
+export interface ExtensionSettingsGetSettingResult {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.GET_SETTING;
+    readonly setting: ExtensionSettingsSelectedValue;
+}
+export interface ExtensionSettingsUpdateSettingResult {
+    readonly extensionId: string;
+    readonly contributionId: string;
+    readonly capability: typeof OPENWAGGLE_EXTENSION_BROKER.CAPABILITY.SETTINGS;
+    readonly method: typeof OPENWAGGLE_EXTENSION_BROKER.METHOD.UPDATE_SETTING;
+    readonly setting: ExtensionSettingsSelectedValue;
+}

package/dist/openwaggle-types.js

@@ -0,0 +1 @@
+export {};