@vibesdotdev/workboard 0.0.0-stage → 1.0.0-rc.1

package/dist/marshal/agent/prompts/system.prompt.descriptor.js

@@ -0,0 +1,63 @@
+import { definePromptManifestDescriptor } from '@vibesdotdev/ai-schemas';
+export default definePromptManifestDescriptor({
+    id: 'workboard.marshal.system',
+    version: '1.0.0',
+    name: 'Marshal (setup concierge)',
+    description: 'Base Marshal system prompt for first-run setup on consumer surfaces.',
+    type: 'system',
+    category: 'chat',
+    tags: ['workboard', 'marshal'],
+    scope: 'builtin',
+    isPublic: false,
+    generator: 'static',
+    content: `You are Marshal, a friendly and knowledgeable platform concierge for the Vibes platform.
+
+## Your Role
+
+You help users:
+- Set up and configure their account
+- Navigate the platform
+- Understand features and capabilities
+- Complete onboarding requirements
+- Troubleshoot configuration issues
+
+## Personality
+
+You are:
+- Friendly and approachable, but professional
+- Patient and helpful
+- Concise - respect the user's time
+- Proactive - suggest next steps
+- Encouraging - celebrate progress
+
+## Guidelines
+
+1. **Be Conversational**: Use natural language, not technical jargon
+2. **Use Tools**: Use the runtime tool API for actions that need data or side effects
+3. **Track Progress**: Update users on what's complete and what's next
+4. **Stay Focused**: Guide users toward completing setup, don't get sidetracked
+5. **Explain Why**: When asking for configuration, explain why it matters
+
+## Available Tools
+
+- **marshal**: Owner-backed delegation tool. Use \`action\` with one of:
+  - \`status\`: report whether authenticated delegation is available
+  - \`delegate\`: send a task to a named agent; pass \`context.agentId\`
+  - \`ask\`: send a question to a named agent; pass \`context.agentId\`
+- **knowledge**: Unified knowledge base operations (search/read/update)
+- **agent**: manage agent records via \`action\` (\`list\` / \`get\` / \`create\` / \`update\` / \`delete\`)
+- **workspace-fs** (actions read, list, search, edit, write, delete) and **workspace-lock**: workspace filesystem operations
+- **file-read / file-write / run-command / git / preview-url**: operate on the bound code-session workspace only. Never invent or override a session id; the execution context binds it and rejects mismatches.
+- **session-scratchpad / session-todo**: capture working context and tasks
+- **tool-help**: discover tool schemas and examples
+
+## Important
+
+- Never make configuration changes without user confirmation
+- Always explain what you're about to do before doing it
+- If unsure, ask clarifying questions
+- Respect user preferences for detail level
+- Never emit fake tool markup like \`[TOOL_CALL]\` in plain text; invoke real tools directly
+`
+}, { owner: 'workboard' });
+//# sourceMappingURL=system.prompt.descriptor.js.map

package/dist/marshal/agent/prompts/system.prompt.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.prompt.descriptor.js","sourceRoot":"","sources":["../../../../src/marshal/agent/prompts/system.prompt.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,eAAe,8BAA8B,CAAC;IAC7C,EAAE,EAAE,0BAA0B;IAC9B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,sEAAsE;IACnF,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IAC9B,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDT;CACA,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC"}

package/dist/marshal/agent/system-prompt.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Marshal System Prompt
+ *
+ * The system prompt that defines Marshal's personality and behavior.
+ */
+import type { MarshalContext, MarshalSetupContext } from '../types.ts';
+/**
+ * Base Marshal system prompt (the `workboard.marshal.system` prompts/manifest descriptor).
+ */
+export declare const marshalSystemPrompt: string;
+/**
+ * Canonical cloud/web Marshal system prompt.
+ *
+ * This is the prompt used by the runtime-discovered Marshal agent on Chat and
+ * the universal messenger dock. Unlike {@link marshalSystemPrompt}
+ * (which is oriented toward first-run setup on consumer surfaces), this prompt
+ * frames Marshal as a general-purpose assistant available on every page that can
+ * manage the user's data across the vibes apps, navigate the platform, and
+ * explain features.
+ *
+ * Wired through the Marshal `tools/agent/instance` descriptor's `promptTemplate`,
+ * which the native agent loop prepends as a trusted system message.
+ * Which tools actually resolve is decided by the runtime scope: in the cloud the
+ * `api-request` tool is registered (cross-app CRUD) while the consumer-only
+ * `fs-*` tools are not; on a consumer surface the reverse holds. Marshal is told
+ * to use whatever is available, so a single prompt adapts to both surfaces.
+ */
+export declare const marshalCloudSystemPrompt: string;
+/**
+ * Build a contextual prompt for Marshal from its prompts/manifest sections.
+ * Synchronous and runtime-free, so each section renders its own manifest.
+ */
+export declare function buildMarshalPrompt(context: MarshalContext, setupContext?: MarshalSetupContext): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/marshal/agent/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../src/marshal/agent/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAiB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQtF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAiD,CAAC;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,QAAsD,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,mBAAmB,GAChC,MAAM,CAoBR"}

package/dist/marshal/agent/system-prompt.js

@@ -0,0 +1,130 @@
+/**
+ * Marshal System Prompt
+ *
+ * The system prompt that defines Marshal's personality and behavior.
+ */
+import { renderPromptManifest } from '@vibesdotdev/ai-schemas';
+import marshalSystemPromptDescriptor from "./prompts/system.prompt.descriptor.js";
+import marshalCloudSystemPromptDescriptor from "./prompts/cloud-system.prompt.descriptor.js";
+import personalityPrompt from "./prompts/personality.prompt.descriptor.js";
+import setupIssuePrompt from "./prompts/setup-issue.prompt.descriptor.js";
+import setupWizardPrompt from "./prompts/setup-wizard.prompt.descriptor.js";
+import surfacePrompt from "./prompts/surface.prompt.descriptor.js";
+/**
+ * Base Marshal system prompt (the `workboard.marshal.system` prompts/manifest descriptor).
+ */
+export const marshalSystemPrompt = marshalSystemPromptDescriptor.manifest.content;
+/**
+ * Canonical cloud/web Marshal system prompt.
+ *
+ * This is the prompt used by the runtime-discovered Marshal agent on Chat and
+ * the universal messenger dock. Unlike {@link marshalSystemPrompt}
+ * (which is oriented toward first-run setup on consumer surfaces), this prompt
+ * frames Marshal as a general-purpose assistant available on every page that can
+ * manage the user's data across the vibes apps, navigate the platform, and
+ * explain features.
+ *
+ * Wired through the Marshal `tools/agent/instance` descriptor's `promptTemplate`,
+ * which the native agent loop prepends as a trusted system message.
+ * Which tools actually resolve is decided by the runtime scope: in the cloud the
+ * `api-request` tool is registered (cross-app CRUD) while the consumer-only
+ * `fs-*` tools are not; on a consumer surface the reverse holds. Marshal is told
+ * to use whatever is available, so a single prompt adapts to both surfaces.
+ */
+export const marshalCloudSystemPrompt = marshalCloudSystemPromptDescriptor.manifest.content;
+/**
+ * Build a contextual prompt for Marshal from its prompts/manifest sections.
+ * Synchronous and runtime-free, so each section renders its own manifest.
+ */
+export function buildMarshalPrompt(context, setupContext) {
+    const sections = [marshalSystemPrompt];
+    // Add personality customization
+    if (context.marshalConfig) {
+        sections.push(buildPersonalitySection(context.marshalConfig));
+    }
+    // Add setup issue mode context (takes precedence over general setup wizard)
+    if (setupContext?.isSetupMode && setupContext.issue) {
+        sections.push(buildSetupIssueModeSection(setupContext));
+    }
+    else if (context.isSetupWizard) {
+        // Add general setup wizard context
+        sections.push(buildSetupWizardSection(context));
+    }
+    // Add surface-specific guidance
+    sections.push(buildSurfaceSection(context.surface, context.capabilities));
+    return sections.join('\n\n');
+}
+function buildPersonalitySection(config) {
+    return renderPromptManifest(personalityPrompt.manifest, {
+        name: config.name,
+        concise: config.personality === 'concise',
+        conversational: config.personality === 'conversational',
+        detailed: config.personality === 'detailed',
+        professional: config.voiceTone === 'professional',
+        friendly: config.voiceTone === 'friendly',
+        casual: config.voiceTone === 'casual',
+        customInstructions: config.customInstructions ?? ''
+    });
+}
+/** Setup issue mode (triggered from SetupBanner). */
+function buildSetupIssueModeSection(setupContext) {
+    const { issue, pendingRequirements, progress } = setupContext;
+    const otherPending = pendingRequirements.filter((r) => r.requirementId !== issue?.requirementId);
+    const otherPendingLines = otherPending
+        .slice(0, 5)
+        .map((req) => `- ${req.severity === 'blocking' ? '[Required]' : '[Optional]'} ${req.label}`);
+    if (otherPending.length > 5)
+        otherPendingLines.push(`- ... and ${otherPending.length - 5} more`);
+    return renderPromptManifest(setupIssuePrompt.manifest, {
+        hasIssue: Boolean(issue),
+        issueId: issue?.requirementId ?? '',
+        issueLabel: issue?.label ?? '',
+        issueStatus: issue?.status ?? '',
+        issueSeverity: issue?.severity ?? '',
+        issueReason: issue?.reason ?? '',
+        issueManualRoute: issue?.manualRoute ?? '',
+        issueCliCommand: issue?.cliCommand ?? '',
+        otherPendingCount: otherPending.length,
+        otherPendingLines: otherPendingLines.join('\n'),
+        progress: Math.round(progress)
+    });
+}
+function buildSetupWizardSection(context) {
+    const { setupStatus } = context;
+    const incomplete = setupStatus.requirements.filter((r) => r.status !== 'complete');
+    const { counts } = setupStatus;
+    return renderPromptManifest(setupWizardPrompt.manifest, {
+        hasBlockingIssues: setupStatus.hasBlockingIssues,
+        remainingLines: incomplete
+            .map((req) => `- ${req.severity === 'blocking' ? '[REQUIRED]' : '[Optional]'} ${req.label}: ${req.reason}`)
+            .join('\n'),
+        hasNextStep: Boolean(setupStatus.nextStep),
+        nextStepLabel: setupStatus.nextStep?.label ?? '',
+        nextStepReason: setupStatus.nextStep?.reason ?? '',
+        complete: counts.complete,
+        incomplete: counts.incomplete,
+        missing: counts.missing
+    });
+}
+function buildSurfaceSection(surface, capabilities) {
+    const caps = [];
+    if (capabilities.canNavigate)
+        caps.push('navigation');
+    if (capabilities.canShowWidgets)
+        caps.push('widgets');
+    if (capabilities.canModifyConfig)
+        caps.push('configuration');
+    if (capabilities.canShowProgress)
+        caps.push('progress tracking');
+    if (capabilities.canAskQuestions)
+        caps.push('interactive questions');
+    return renderPromptManifest(surfacePrompt.manifest, {
+        surfaceName: surface.toUpperCase(),
+        web: surface === 'web',
+        tui: surface === 'tui',
+        cli: surface === 'cli',
+        bridge: surface === 'bridge',
+        capabilities: caps.join(', ')
+    });
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/marshal/agent/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../src/marshal/agent/system-prompt.ts"],"names":[],"mappings":"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"}

package/dist/marshal/capabilities.d.ts

@@ -0,0 +1,55 @@
+import type { MarshalSurface } from './types.ts';
+export declare const MARSHAL_LIVE_CAPABILITY_IDS: readonly ["user_messages", "plan_confirmations", "stimulus_routing", "svelte_applets", "code_sessions", "internal_operations"];
+export type MarshalLiveCapabilityId = (typeof MARSHAL_LIVE_CAPABILITY_IDS)[number];
+export type MarshalLiveCapabilityStatus = 'live' | 'partial' | 'contract' | 'gap';
+export interface MarshalLiveCapabilityRoutes {
+    user_messages?: string;
+    plan_confirmations?: string;
+    stimulus_routing?: string;
+    svelte_applets?: string;
+    code_sessions?: string;
+    internal_operations?: string;
+}
+export interface MarshalLiveCapabilityFacts {
+    surface?: MarshalSurface;
+    routes?: MarshalLiveCapabilityRoutes;
+    hasWorkboardNotifications?: boolean;
+    hasWorkboardRequests?: boolean;
+    hasWorkboardTasks?: boolean;
+    hasRequestReview?: boolean;
+    hasArtifactSurface?: boolean;
+    hasCodeSessionSurface?: boolean;
+    /** agent/event-source descriptors + webhook ingress present */
+    hasStimulusRouter?: boolean;
+    /**
+     * True when inbound can wake a live agent (source-message → CHAT_GENERATION)
+     * and deployments can bind eventSources. Without this, stimulus is log-only.
+     */
+    hasStimulusLiveWake?: boolean;
+    /**
+     * True when agents can send on message sources (message-send tool and/or
+     * email tool on allowLists / registered).
+     */
+    hasStimulusOutboundTool?: boolean;
+    notificationCount?: number;
+    pendingRequestCount?: number;
+    activeTaskCount?: number;
+    artifactCount?: number;
+    componentArtifactCount?: number;
+    codeSessionCount?: number;
+    activeStimulusCount?: number;
+    configuredStimulusCount?: number;
+    internalScope?: boolean;
+}
+export interface MarshalLiveCapability {
+    id: MarshalLiveCapabilityId;
+    title: string;
+    status: MarshalLiveCapabilityStatus;
+    ownerPackage: string;
+    detail: string;
+    evidence: string[];
+    href?: string;
+    actionLabel: string;
+}
+export declare function resolveMarshalLiveCapabilities(facts: MarshalLiveCapabilityFacts): MarshalLiveCapability[];
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/marshal/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/marshal/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,2BAA2B,gIAO9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AACnF,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;AAElF,MAAM,WAAW,2BAA2B;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IAC1C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,uBAAuB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,2BAA2B,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAiBD,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,0BAA0B,GAC/B,qBAAqB,EAAE,CAoIzB"}

package/dist/marshal/capabilities.js

@@ -0,0 +1,146 @@
+export const MARSHAL_LIVE_CAPABILITY_IDS = [
+    'user_messages',
+    'plan_confirmations',
+    'stimulus_routing',
+    'svelte_applets',
+    'code_sessions',
+    'internal_operations'
+];
+function countLabel(count, singular, plural = `${singular}s`) {
+    return `${count} ${count === 1 ? singular : plural}`;
+}
+function route(routes, id) {
+    return routes?.[id];
+}
+function nonNegative(value) {
+    return Math.max(0, value ?? 0);
+}
+export function resolveMarshalLiveCapabilities(facts) {
+    const routes = facts.routes;
+    const notificationCount = nonNegative(facts.notificationCount);
+    const pendingRequestCount = nonNegative(facts.pendingRequestCount);
+    const activeTaskCount = nonNegative(facts.activeTaskCount);
+    const artifactCount = nonNegative(facts.artifactCount);
+    const componentArtifactCount = nonNegative(facts.componentArtifactCount);
+    const codeSessionCount = nonNegative(facts.codeSessionCount);
+    const activeStimulusCount = nonNegative(facts.activeStimulusCount);
+    const configuredStimulusCount = nonNegative(facts.configuredStimulusCount);
+    const hasRequests = facts.hasWorkboardRequests === true;
+    const hasRequestReview = facts.hasRequestReview === true;
+    const hasNotifications = facts.hasWorkboardNotifications === true;
+    const hasStimulusRouter = facts.hasStimulusRouter === true;
+    const hasStimulusLiveWake = facts.hasStimulusLiveWake === true;
+    const hasStimulusOutboundTool = facts.hasStimulusOutboundTool === true;
+    const hasArtifactSurface = facts.hasArtifactSurface === true;
+    const hasCodeSessionSurface = facts.hasCodeSessionSurface === true;
+    return [
+        {
+            id: 'user_messages',
+            title: 'User messages',
+            status: hasNotifications ? 'live' : 'gap',
+            ownerPackage: '@vibesdotdev/workboard + @vibesdotdev/hq',
+            detail: hasNotifications
+                ? `Agents can post workboard notifications and surface artifacts; ${countLabel(notificationCount, 'message')} visible now.`
+                : 'No agent-to-user notification surface is registered for this Marshal scope.',
+            evidence: hasNotifications
+                ? ['workboard.notification endpoint', 'hq.surface notification schema']
+                : [],
+            href: route(routes, 'user_messages'),
+            actionLabel: 'Open messages'
+        },
+        {
+            id: 'plan_confirmations',
+            title: 'Plan confirmations',
+            status: hasRequests && hasRequestReview ? 'live' : hasRequests ? 'partial' : 'gap',
+            ownerPackage: '@vibesdotdev/workboard',
+            detail: hasRequests && hasRequestReview
+                ? `Structured approvals are reviewable; ${countLabel(pendingRequestCount, 'pending request')} waiting.`
+                : hasRequests
+                    ? 'Requests can be created, but the review action is not wired for this surface.'
+                    : 'No workboard request queue is registered for this Marshal scope.',
+            evidence: [
+                ...(hasRequests ? ['workboard.request endpoint'] : []),
+                ...(hasRequestReview ? ['workboard.request review action'] : [])
+            ],
+            href: route(routes, 'plan_confirmations'),
+            actionLabel: 'Review approvals'
+        },
+        {
+            id: 'stimulus_routing',
+            title: 'Event routing',
+            status: hasStimulusRouter &&
+                hasStimulusLiveWake &&
+                hasStimulusOutboundTool &&
+                configuredStimulusCount > 0
+                ? 'live'
+                : hasStimulusRouter && (hasStimulusLiveWake || hasStimulusOutboundTool)
+                    ? 'partial'
+                    : hasStimulusRouter
+                        ? 'contract'
+                        : 'gap',
+            ownerPackage: '@vibesdotdev/agents + tools + integrations',
+            detail: !hasStimulusRouter
+                ? 'No message, webhook, schedule, or integration router is registered for this scope.'
+                : hasStimulusLiveWake && hasStimulusOutboundTool
+                    ? `${countLabel(activeStimulusCount, 'active source')} feeding ${countLabel(configuredStimulusCount, 'configured source')}; inbound can wake agents and message-send is registered.`
+                    : hasStimulusLiveWake
+                        ? `${countLabel(configuredStimulusCount, 'configured source')}; inbound wake wired, outbound message-send tool not yet evidenced.`
+                        : hasStimulusOutboundTool
+                            ? `${countLabel(configuredStimulusCount, 'configured source')}; outbound tool present, inbound live wake not evidenced.`
+                            : `${countLabel(configuredStimulusCount, 'configured source')} catalog-only — no live wake or outbound tool evidence.`,
+            evidence: [
+                ...(hasStimulusRouter ? ['agent/event-source descriptors', 'webhook ingress'] : []),
+                ...(hasStimulusLiveWake
+                    ? ['agents/stimulus match', 'source-message wake → chat.generation.run']
+                    : []),
+                ...(hasStimulusOutboundTool ? ['tools/tool message-send'] : [])
+            ],
+            href: route(routes, 'stimulus_routing'),
+            actionLabel: 'Manage sources'
+        },
+        {
+            id: 'svelte_applets',
+            title: 'Svelte applets',
+            status: componentArtifactCount > 0 ? 'live' : hasArtifactSurface ? 'contract' : 'gap',
+            ownerPackage: '@vibesdotdev/hq + @vibesdotdev/platform',
+            detail: componentArtifactCount > 0
+                ? `${countLabel(componentArtifactCount, 'component-backed artifact')} visible from ${countLabel(artifactCount, 'artifact')}; HQ can render registry-backed or inline browser-runtime applets.`
+                : hasArtifactSurface
+                    ? 'Surface artifacts can now carry component/app references; no component-backed output is visible yet.'
+                    : 'No HQ artifact surface is registered for applets.',
+            evidence: [
+                ...(hasArtifactSurface ? ['hq surface artifact schema'] : []),
+                ...(componentArtifactCount > 0
+                    ? ['componentRef artifact projection', 'platform component registry']
+                    : [])
+            ],
+            href: route(routes, 'svelte_applets'),
+            actionLabel: 'Review applets'
+        },
+        {
+            id: 'code_sessions',
+            title: 'Code sessions',
+            status: codeSessionCount > 0 ? 'live' : hasCodeSessionSurface ? 'partial' : 'gap',
+            ownerPackage: '@vibesdotdev/agent-execution/code-session',
+            detail: hasCodeSessionSurface
+                ? `${countLabel(codeSessionCount, 'code workspace')} linked to live agents; ${countLabel(activeTaskCount, 'active task')} in the queue.`
+                : 'No code-session surface is registered for this Marshal scope.',
+            evidence: hasCodeSessionSurface ? ['agent-code-session route', 'fleet runtime target'] : [],
+            href: route(routes, 'code_sessions'),
+            actionLabel: 'Open sessions'
+        },
+        {
+            id: 'internal_operations',
+            title: 'Internal Marshal powers',
+            status: facts.internalScope ? 'live' : 'partial',
+            ownerPackage: 'vibes org scope',
+            detail: facts.internalScope
+                ? 'Vibes org scope can expose admin-only Marshal operations and internal fleet controls.'
+                : 'Internal operations are hidden until the current user is in the vibes org scope.',
+            evidence: facts.internalScope ? ['internal scope gate'] : ['public scope gate'],
+            href: route(routes, 'internal_operations'),
+            actionLabel: 'Open internal'
+        }
+    ];
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/marshal/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/marshal/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/kernel/schemas/asset';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=fleet.marshal-presence.heartbeat.command.descriptor.d.ts.map

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet.marshal-presence.heartbeat.command.descriptor.d.ts","sourceRoot":"","sources":["../../../src/marshal/cli/fleet.marshal-presence.heartbeat.command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,QAAA,MAAM,UAAU,EAAE,yBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.descriptor.js

@@ -0,0 +1,18 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'fleet.marshal-presence.heartbeat',
+    name: 'heartbeat',
+    description: 'Publish one authenticated Marshal presence heartbeat to HQ',
+    group: 'fleet.marshal-presence',
+    arguments: [],
+    options: [
+        { flags: '--agent-id <id>', description: 'Presence agent id (default: marshal.live)' },
+        { flags: '--machine-id <id>', description: 'Stable machine id' },
+        { flags: '--machine-name <name>', description: 'Machine display name (default: Marshal)' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=fleet.marshal-presence.heartbeat.command.descriptor.js.map

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet.marshal-presence.heartbeat.command.descriptor.js","sourceRoot":"","sources":["../../../src/marshal/cli/fleet.marshal-presence.heartbeat.command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,kCAAkC;IACtC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,4DAA4D;IACzE,KAAK,EAAE,wBAAwB;IAC/B,SAAS,EAAE,EAAE;IACb,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,2CAA2C,EAAE;QACtF,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,mBAAmB,EAAE;QAChE,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,yCAAyC,EAAE;KAC1F;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.impl.consumer.d.ts

@@ -0,0 +1,16 @@
+import * as z from 'zod/v4';
+import type { CommandContext } from '@vibesdotdev/cli';
+declare const MarshalPresenceHeartbeatArgsSchema: z.ZodObject<{}, z.core.$loose>;
+export type MarshalPresenceHeartbeatArgs = z.infer<typeof MarshalPresenceHeartbeatArgsSchema>;
+declare const MarshalPresenceHeartbeatOptionsSchema: z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodString>;
+    machineId: z.ZodOptional<z.ZodString>;
+    machineName: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type MarshalPresenceHeartbeatOptions = z.infer<typeof MarshalPresenceHeartbeatOptionsSchema>;
+export declare class MarshalPresenceHeartbeatCommand {
+    execute(_args: MarshalPresenceHeartbeatArgs, rawOptions: MarshalPresenceHeartbeatOptions, context: CommandContext): Promise<void>;
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof MarshalPresenceHeartbeatCommand>;
+export default _default;
+//# sourceMappingURL=fleet.marshal-presence.heartbeat.command.impl.consumer.d.ts.map

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet.marshal-presence.heartbeat.command.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/marshal/cli/fleet.marshal-presence.heartbeat.command.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,QAAA,MAAM,kCAAkC,gCAA6B,CAAC;AACtE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,QAAA,MAAM,qCAAqC;;;;iBAI3B,CAAC;AAEjB,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAcpG,qBAAa,+BAA+B;IACrC,OAAO,CACZ,KAAK,EAAE,4BAA4B,EACnC,UAAU,EAAE,+BAA+B,EAC3C,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;CAmBhB;;AAED,wBAIG"}

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.impl.consumer.js

@@ -0,0 +1,39 @@
+import * as z from 'zod/v4';
+import { getPathRoots } from '@vibesdotdev/paths';
+import { createRuntimeImplementation } from '@vibesdotdev/kernel';
+const MarshalPresenceHeartbeatArgsSchema = z.object({}).passthrough();
+const MarshalPresenceHeartbeatOptionsSchema = z.object({
+    agentId: z.string().trim().min(1).optional(),
+    machineId: z.string().trim().min(1).optional(),
+    machineName: z.string().trim().min(1).optional()
+}).passthrough();
+function resolvedOption(runtime, optionValue, envKey, fallback) {
+    if (optionValue !== undefined && optionValue.length > 0)
+        return optionValue;
+    const envValue = runtime.getEnv(envKey)?.trim();
+    if (envValue !== undefined && envValue.length > 0)
+        return envValue;
+    return fallback;
+}
+export class MarshalPresenceHeartbeatCommand {
+    async execute(_args, rawOptions, context) {
+        const options = MarshalPresenceHeartbeatOptionsSchema.parse(rawOptions ?? {});
+        // Dynamic import: marshal depends on agents/presence which cycle back to
+        // platform through chat/ai-svelte. fleets/cli plugin loads marshal only
+        // when this command runs — isolated optional surface, no package edge.
+        const { marshalPresenceHeartbeatDependencies, publishMarshalPresenceHeartbeat } = await import("../presence/index.js");
+        const receipt = await publishMarshalPresenceHeartbeat({
+            agentId: resolvedOption(context.runtime, options.agentId, 'VIBES_AGENT_ID', 'marshal.live'),
+            machineId: resolvedOption(context.runtime, options.machineId, 'VIBES_MACHINE_ID', 'marshal-live'),
+            machineName: resolvedOption(context.runtime, options.machineName, 'VIBES_MACHINE_NAME', 'Marshal'),
+            vibesHome: getPathRoots(context.runtime).vibesHome
+        }, marshalPresenceHeartbeatDependencies(context.runtime));
+        process.stdout.write(`Marshal presence heartbeat OK (HTTP ${receipt.status}, expires ${receipt.body.expiresInSeconds}s)\n`);
+    }
+}
+export default createRuntimeImplementation({
+    kind: 'cli/command',
+    id: 'fleet.marshal-presence.heartbeat',
+    implementation: MarshalPresenceHeartbeatCommand
+});
+//# sourceMappingURL=fleet.marshal-presence.heartbeat.command.impl.consumer.js.map

package/dist/marshal/cli/fleet.marshal-presence.heartbeat.command.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet.marshal-presence.heartbeat.command.impl.consumer.js","sourceRoot":"","sources":["../../../src/marshal/cli/fleet.marshal-presence.heartbeat.command.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAGtE,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,WAAW,EAAE,CAAC;AAIjB,SAAS,cAAc,CACtB,OAAqB,EACrB,WAA+B,EAC/B,MAAc,EACd,QAAgB;IAEhB,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC;IAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnE,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,+BAA+B;IAC3C,KAAK,CAAC,OAAO,CACZ,KAAmC,EACnC,UAA2C,EAC3C,OAAuB;QAEvB,MAAM,OAAO,GAAG,qCAAqC,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC9E,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,EAAE,oCAAoC,EAAE,+BAA+B,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACvH,MAAM,OAAO,GAAG,MAAM,+BAA+B,CACpD;YACC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,CAAC;YAC3F,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,kBAAkB,EAAE,cAAc,CAAC;YACjG,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,SAAS,CAAC;YAClG,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS;SAClD,EACD,oCAAoC,CAAC,OAAO,CAAC,OAAO,CAAC,CACrD,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,uCAAuC,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,CACrG,CAAC;IACH,CAAC;CACD;AAED,eAAe,2BAA2B,CAAC;IAC1C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,kCAAkC;IACtC,cAAc,EAAE,+BAA+B;CAC/C,CAAC,CAAC"}

package/dist/marshal/cli/plugin.d.ts

@@ -0,0 +1,3 @@
+export declare const marshalPresenceCliPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default marshalPresenceCliPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/marshal/cli/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/marshal/cli/plugin.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,6CAInC,CAAC;AACH,eAAe,wBAAwB,CAAC"}

package/dist/marshal/cli/plugin.js

@@ -0,0 +1,9 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import heartbeat from "./fleet.marshal-presence.heartbeat.command.descriptor.js";
+export const marshalPresenceCliPlugin = createRuntimePlugin({
+    id: '@vibesdotdev/workboard/marshal/cli', name: 'Marshal Presence CLI',
+    dependencies: ['cli'], descriptors: [heartbeat],
+    loaders: [loader(heartbeat.id, { kind: 'cli/command', scope: { hardware: ['consumer'] } }, () => import("./fleet.marshal-presence.heartbeat.command.impl.consumer.js"))]
+});
+export default marshalPresenceCliPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/marshal/cli/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/marshal/cli/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,SAAS,MAAM,0DAA0D,CAAC;AACjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;IAC3D,EAAE,EAAE,oCAAoC,EAAE,IAAI,EAAE,sBAAsB;IACtE,YAAY,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,SAAS,CAAC;IAC/C,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAAC,CAAC;CACxK,CAAC,CAAC;AACH,eAAe,wBAAwB,CAAC"}

package/dist/marshal/client/helper.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Marshal Client Helper
+ *
+ * Provides the handed-runtime accessor for the canonical Marshal runtime client.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { MarshalClient, MarshalRuntimeClient } from './marshal-client.runtime.ts';
+/**
+ * Get the canonical Marshal runtime client.
+ *
+ * This is the preferred way to access Marshal functionality from consumers.
+ * The client is lazily loaded and cached by the runtime.
+ *
+ * @example
+ *   const marshal = await getVibesMarshalClient(runtime);
+ *   const config = await marshal.config.get();
+ *   const progress = await marshal.progress.get();
+ */
+export declare function getVibesMarshalClient(runtime: RuntimeRef): Promise<MarshalClient>;
+/**
+ * Type guard for MarshalRuntimeClient interface.
+ */
+export declare function isMarshalClient<T>(client: T): client is T & MarshalRuntimeClient;
+//# sourceMappingURL=helper.d.ts.map

package/dist/marshal/client/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../src/marshal/client/helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAEvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,oBAAoB,CAUhF"}