@taskforcehq/taskforce 0.3.329 → 0.3.332

package/dist/components/features/agentConnections/modelConnectionsApi.d.ts

@@ -0,0 +1,65 @@
+export type ModelConnectionLifecycleStatus = 'pending' | 'active' | 'reconnect_required' | 'revoked' | 'disconnected';
+export type ModelConnection = {
+    id: string;
+    providerKey: string;
+    authenticationType: string;
+    lifecycleStatus: ModelConnectionLifecycleStatus;
+    displayMetadata: {
+        displayName?: string;
+        accountEmail?: string;
+        accountLabel?: string;
+        planLabel?: string;
+    };
+    lastVerifiedAt: string | null;
+    lastRefreshedAt: string | null;
+    failureCode: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type DeviceCodeLoginSession = {
+    id: string;
+    connectionId: string;
+    status: 'pending' | 'active' | 'failed' | 'cancelled' | 'expired';
+    userCode: string;
+    verificationUrl: string;
+    expiresAt: string;
+    failureCode?: string;
+};
+export type AgentConnectionBinding = {
+    bound: boolean;
+    available: boolean;
+    providerKey?: string;
+    modelSource?: string;
+    ownerIsCaller?: boolean;
+    connectionId?: string;
+    reasonCode?: string;
+};
+export type ModelConnectionsSnapshot = {
+    eligible: boolean;
+    connections: ModelConnection[];
+};
+export declare class ModelConnectionsApiError extends Error {
+    readonly code?: string | undefined;
+    readonly status?: number | undefined;
+    constructor(message: string, code?: string | undefined, status?: number | undefined);
+}
+export type ModelConnectionsApiContext = {
+    apiBaseUrl?: string;
+    workspaceId?: string;
+    resolveApiUrl?: (path: string) => string;
+};
+export declare function listModelConnections(context: ModelConnectionsApiContext): Promise<ModelConnection[]>;
+export declare function loadModelConnectionsSnapshot(context: ModelConnectionsApiContext): Promise<ModelConnectionsSnapshot>;
+export declare function createOpenAiCodexConnection(context: ModelConnectionsApiContext): Promise<ModelConnection>;
+export declare function startDeviceCodeLogin(connectionId: string, context: ModelConnectionsApiContext): Promise<DeviceCodeLoginSession>;
+export declare function getDeviceCodeLogin(connectionId: string, sessionId: string, context: ModelConnectionsApiContext): Promise<DeviceCodeLoginSession>;
+export declare function cancelDeviceCodeLogin(connectionId: string, sessionId: string, context: ModelConnectionsApiContext): Promise<DeviceCodeLoginSession>;
+export declare const verifyModelConnection: (connectionId: string, context: ModelConnectionsApiContext) => Promise<ModelConnection>;
+export declare const refreshModelConnection: (connectionId: string, context: ModelConnectionsApiContext) => Promise<ModelConnection>;
+export declare const disconnectModelConnection: (connectionId: string, context: ModelConnectionsApiContext) => Promise<ModelConnection>;
+export declare function renameModelConnection(connectionId: string, displayName: string, context: ModelConnectionsApiContext): Promise<ModelConnection>;
+export declare function removeModelConnection(connectionId: string, context: ModelConnectionsApiContext): Promise<void>;
+export declare function inspectAgentConnectionBinding(agentId: string, context: ModelConnectionsApiContext): Promise<AgentConnectionBinding>;
+export declare function bindAgentConnection(agentId: string, connectionId: string, context: ModelConnectionsApiContext): Promise<AgentConnectionBinding>;
+export declare function clearAgentConnectionBinding(agentId: string, context: ModelConnectionsApiContext): Promise<void>;
+export declare function modelConnectionFailureMessage(code: string | null | undefined, fallback?: string): string;

package/dist/components/features/agentConnections/modelConnectionsApi.js

@@ -0,0 +1,129 @@
+import { fetchTaskforceApi } from '../../../utils/taskforceApiClient.js';
+export class ModelConnectionsApiError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = 'ModelConnectionsApiError';
+    }
+}
+async function requestJson(path, init, context) {
+    const headers = new Headers(init?.headers || undefined);
+    if (init?.body)
+        headers.set('Content-Type', 'application/json');
+    const workspaceId = String(context.workspaceId || '').trim();
+    if (workspaceId && workspaceId !== 'default')
+        headers.set('x-taskforce-workspace-id', workspaceId);
+    const requestPath = context.resolveApiUrl?.(path) || path;
+    const response = await fetchTaskforceApi(requestPath, {
+        credentials: 'include',
+        ...init,
+        headers,
+    }, context.apiBaseUrl);
+    const payload = await response.json().catch(() => ({}));
+    if (!response.ok || payload.success === false) {
+        throw new ModelConnectionsApiError(String(payload.error || `Model connection request failed (${response.status}).`), payload.code, response.status);
+    }
+    return payload;
+}
+export async function listModelConnections(context) {
+    const payload = await requestJson('/api/taskforce/model-connections', undefined, context);
+    return Array.isArray(payload.connections) ? payload.connections : [];
+}
+export async function loadModelConnectionsSnapshot(context) {
+    const payload = await requestJson('/api/taskforce/model-connections', undefined, context);
+    return {
+        eligible: payload.eligible === true,
+        connections: Array.isArray(payload.connections) ? payload.connections : [],
+    };
+}
+export async function createOpenAiCodexConnection(context) {
+    const payload = await requestJson('/api/taskforce/model-connections', {
+        method: 'POST',
+        body: JSON.stringify({
+            providerKey: 'openai',
+            authenticationType: 'chatgpt_device_code',
+        }),
+    }, context);
+    if (!payload.connection)
+        throw new ModelConnectionsApiError('Model connection response was incomplete.');
+    return payload.connection;
+}
+export async function startDeviceCodeLogin(connectionId, context) {
+    const payload = await requestJson(`/api/taskforce/model-connections/${encodeURIComponent(connectionId)}/login`, { method: 'POST' }, context);
+    if (!payload.login)
+        throw new ModelConnectionsApiError('Device authorization response was incomplete.');
+    return payload.login;
+}
+export async function getDeviceCodeLogin(connectionId, sessionId, context) {
+    const payload = await requestJson(`/api/taskforce/model-connections/${encodeURIComponent(connectionId)}/login/${encodeURIComponent(sessionId)}`, undefined, context);
+    if (!payload.login)
+        throw new ModelConnectionsApiError('Device authorization response was incomplete.');
+    return payload.login;
+}
+export async function cancelDeviceCodeLogin(connectionId, sessionId, context) {
+    const payload = await requestJson(`/api/taskforce/model-connections/${encodeURIComponent(connectionId)}/login/${encodeURIComponent(sessionId)}/cancel`, { method: 'POST' }, context);
+    if (!payload.login)
+        throw new ModelConnectionsApiError('Device authorization response was incomplete.');
+    return payload.login;
+}
+async function runConnectionOperation(connectionId, operation, context) {
+    const payload = await requestJson(`/api/taskforce/model-connections/${encodeURIComponent(connectionId)}/${operation}`, { method: 'POST' }, context);
+    if (!payload.connection)
+        throw new ModelConnectionsApiError('Model connection response was incomplete.');
+    return payload.connection;
+}
+export const verifyModelConnection = (connectionId, context) => (runConnectionOperation(connectionId, 'verify', context));
+export const refreshModelConnection = (connectionId, context) => (runConnectionOperation(connectionId, 'refresh', context));
+export const disconnectModelConnection = (connectionId, context) => (runConnectionOperation(connectionId, 'disconnect', context));
+export async function renameModelConnection(connectionId, displayName, context) {
+    const payload = await requestJson(`/api/taskforce/model-connections/${encodeURIComponent(connectionId)}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ displayName }),
+    }, context);
+    if (!payload.connection)
+        throw new ModelConnectionsApiError('Model connection response was incomplete.');
+    return payload.connection;
+}
+export async function removeModelConnection(connectionId, context) {
+    await requestJson(`/api/taskforce/model-connections/${encodeURIComponent(connectionId)}`, { method: 'DELETE' }, context);
+}
+export async function inspectAgentConnectionBinding(agentId, context) {
+    const workspaceId = encodeURIComponent(String(context.workspaceId || '').trim());
+    const payload = await requestJson(`/api/taskforce/agents/${encodeURIComponent(agentId)}/connection-binding?workspaceId=${workspaceId}`, undefined, context);
+    return payload.binding || { bound: false, available: false, reasonCode: 'MODEL_CONNECTION_REQUIRED' };
+}
+export async function bindAgentConnection(agentId, connectionId, context) {
+    const payload = await requestJson(`/api/taskforce/agents/${encodeURIComponent(agentId)}/connection-binding`, {
+        method: 'PUT',
+        body: JSON.stringify({ workspaceId: context.workspaceId, connectionId }),
+    }, context);
+    if (!payload.binding)
+        throw new ModelConnectionsApiError('Agent connection response was incomplete.');
+    return payload.binding;
+}
+export async function clearAgentConnectionBinding(agentId, context) {
+    await requestJson(`/api/taskforce/agents/${encodeURIComponent(agentId)}/connection-binding`, {
+        method: 'DELETE',
+        body: JSON.stringify({ workspaceId: context.workspaceId }),
+    }, context);
+}
+export function modelConnectionFailureMessage(code, fallback = 'The connection needs to be authorized again.') {
+    switch (String(code || '').trim().toUpperCase()) {
+        case 'MODEL_CONNECTION_DEVICE_CODE_UNAVAILABLE':
+            return 'ChatGPT device authorization is unavailable for this account. Retry later or use another connection.';
+        case 'MODEL_CONNECTION_RATE_LIMITED':
+            return 'ChatGPT temporarily rate limited this connection. Wait a moment, then retry.';
+        case 'MODEL_CONNECTION_LOGIN_LIMIT_REACHED':
+        case 'MODEL_CONNECTION_LOGIN_CAPACITY_REACHED':
+            return 'Device authorization capacity is temporarily full. Wait a moment, then retry.';
+        case 'MODEL_CONNECTION_LOGIN_CANCELLED':
+            return 'Device authorization was cancelled.';
+        case 'MODEL_CONNECTION_LEASE_LOST':
+            return 'The connection changed while authorization was running. Start again.';
+        default:
+            return fallback;
+    }
+}

package/dist/components/features/planning/PlanningModule.js

@@ -11,6 +11,7 @@ import { PlanningOwnerDropdown, normalizePlanningOwnerOptions, } from './Plannin
 import { buildPlanningNavigatorResults, PLANNING_NAVIGATOR_SORT_OPTIONS, } from './planningNavigator';
 import { PlanningEntitySummary, PlanningReferenceBadge, } from './PlanningEntitySummary';
 import { PlanningVisualIdentity } from './PlanningVisualIdentity';
+import { hasPlanningMetadataChanges } from './planningMetadata';
 import { PlanningTaskCard } from './PlanningTaskCard';
 import { PlanningTaskArrangeControl } from './PlanningTaskArrangeControl';
 import planningDropdownStyles from './PlanningDropdownControl.module.css';
@@ -21,7 +22,7 @@ import { PlanningUnlinkConfirmation, } from './PlanningUnlinkConfirmation';
 import { PlanningLinkPicker } from './PlanningLinkPicker';
 import { PlanningEntityActivity, PlanningEntityContext, PlanningEntityDescription, } from './PlanningEntityDetails';
 import styles from './PlanningModule.module.css';
-function PlanningWorkspaceEditor({ entityType, mode, initialTitle = '', initialDescription = '', ownerOptions, fixedInitiativeId, formId, showActions = true, onSavingChange, onCancel, onSave, }) {
+function PlanningWorkspaceEditor({ entityType, mode, initialTitle = '', initialDescription = '', ownerOptions, fixedInitiativeId, formId, showActions = true, onSavingChange, onDirtyChange, onCancel, onSave, }) {
     const label = entityType === 'initiative' ? 'Initiative' : 'Workstream';
     const titleInputId = React.useId();
     const titleErrorId = React.useId();
@@ -35,6 +36,10 @@ function PlanningWorkspaceEditor({ entityType, mode, initialTitle = '', initialD
     const [titleError, setTitleError] = React.useState(null);
     const [saveError, setSaveError] = React.useState(null);
     const [isSaving, setIsSaving] = React.useState(false);
+    const isDirty = mode === 'create' || hasPlanningMetadataChanges({ title: initialTitle, description: initialDescription }, { title, description });
+    React.useEffect(() => {
+        onDirtyChange?.(isDirty);
+    }, [isDirty, onDirtyChange]);
     React.useEffect(() => {
         titleInputRef.current?.focus();
     }, []);
@@ -48,6 +53,8 @@ function PlanningWorkspaceEditor({ entityType, mode, initialTitle = '', initialD
             titleInputRef.current?.focus();
             return;
         }
+        if (!isDirty)
+            return;
         setTitleError(null);
         setSaveError(null);
         setIsSaving(true);
@@ -87,7 +94,7 @@ function PlanningWorkspaceEditor({ entityType, mode, initialTitle = '', initialD
                                 setTitleError(null);
                         }, placeholder: entityType === 'initiative' ? 'Enter initiative title' : 'Enter workstream title' }), titleError ? _jsx("p", { id: titleErrorId, className: "tf-text-error", children: titleError }) : null] }), _jsxs("div", { className: styles.workspaceEditorField, children: [_jsxs("label", { htmlFor: descriptionInputId, children: [label, " description"] }), _jsx("textarea", { id: descriptionInputId, value: description, disabled: isSaving, rows: 5, onChange: (event) => setDescription(event.target.value), placeholder: entityType === 'initiative'
                             ? 'Describe the broader outcome this initiative is meant to achieve.'
-                            : 'Describe the lane of work this workstream will coordinate.' })] }), mode === 'create' && ownerOptions ? (_jsxs("div", { className: styles.workspaceEditorField, children: [_jsxs("span", { children: [label, " owner"] }), _jsx(PlanningOwnerDropdown, { value: ownerId, options: ownerOptions, onChange: setOwnerId, disabled: isSaving, ariaLabel: `${label} owner`, className: `${planningDropdownStyles.control} ${styles.selectedEntityOwnerDropdown}` })] })) : null, saveError ? _jsx("p", { className: "tf-text-error", role: "alert", children: saveError }) : null, showActions ? _jsxs("div", { className: styles.workspaceEditorActions, children: [_jsx("button", { type: "button", className: "tf-button-secondary tf-button-compact", onClick: onCancel, disabled: isSaving, children: "Cancel" }), _jsxs("button", { type: "submit", className: "tf-button-primary tf-button-compact", disabled: isSaving, children: [isSaving ? _jsx(Loader2, { size: 14, className: styles.spinner, "aria-hidden": "true" }) : null, mode === 'create' ? `Create ${label}` : 'Save'] })] }) : null] }));
+                            : 'Describe the lane of work this workstream will coordinate.' })] }), mode === 'create' && ownerOptions ? (_jsxs("div", { className: styles.workspaceEditorField, children: [_jsxs("span", { children: [label, " owner"] }), _jsx(PlanningOwnerDropdown, { value: ownerId, options: ownerOptions, onChange: setOwnerId, disabled: isSaving, ariaLabel: `${label} owner`, className: `${planningDropdownStyles.control} ${styles.selectedEntityOwnerDropdown}` })] })) : null, saveError ? _jsx("p", { className: "tf-text-error", role: "alert", children: saveError }) : null, showActions ? _jsxs("div", { className: styles.workspaceEditorActions, children: [_jsx("button", { type: "button", className: "tf-button-secondary tf-button-compact", onClick: onCancel, disabled: isSaving, children: "Cancel" }), _jsxs("button", { type: "submit", className: "tf-button-primary tf-button-compact", disabled: isSaving || !isDirty, children: [isSaving ? _jsx(Loader2, { size: 14, className: styles.spinner, "aria-hidden": "true" }) : null, mode === 'create' ? `Create ${label}` : 'Save'] })] }) : null] }));
 }
 function InitiativeButton({ initiative, ownerOption, ownerOptions, workstreamCount, selected, onSelect, onChangeOwner, onChangeIdentity, }) {
     return (_jsxs("div", { className: `${styles.entityCard} ${initiative.isArchived ? styles.entityCardArchived : ''} ${selected ? styles.entityCardSelected : ''}`.trim(), children: [_jsx(PlanningReferenceBadge, { label: formatInitiativeReference(initiative), entityType: "initiative", entityName: initiative.title, interactive: false }), _jsx("div", { className: styles.entityCardBody, children: _jsx("div", { role: "button", tabIndex: 0, className: styles.entityCardContentButton, onClick: onSelect, onKeyDown: (event) => {
@@ -115,6 +122,7 @@ function SelectedEntityContext({ item, entityType, ownerOptions, onChangeOwner,
     const [isSavingOwner, setIsSavingOwner] = React.useState(false);
     const [isEditing, setIsEditing] = React.useState(false);
     const [isEditingSaving, setIsEditingSaving] = React.useState(false);
+    const [isEditingDirty, setIsEditingDirty] = React.useState(false);
     const [archiveConfirmationVisible, setArchiveConfirmationVisible] = React.useState(false);
     const [archiveBusy, setArchiveBusy] = React.useState(false);
     const editFormId = React.useId();
@@ -140,6 +148,7 @@ function SelectedEntityContext({ item, entityType, ownerOptions, onChangeOwner,
     React.useEffect(() => {
         setIsEditing(false);
         setIsEditingSaving(false);
+        setIsEditingDirty(false);
         setArchiveConfirmationVisible(false);
         setArchiveBusy(false);
     }, [item.id]);
@@ -199,7 +208,10 @@ function SelectedEntityContext({ item, entityType, ownerOptions, onChangeOwner,
                                     ? archiveConfirmationVisible
                                     : undefined, children: archiveState.mode === 'archived'
                                     ? _jsx(RotateCcw, { size: 14, "aria-hidden": "true" })
-                                    : _jsx(Archive, { size: 14, "aria-hidden": "true" }) })) : null, !isEditing && !item.isArchived && onUpdate ? (_jsx("button", { type: "button", className: "tf-control-icon", onClick: () => setIsEditing(true), "aria-label": `Edit ${label.toLowerCase()}`, title: `Edit ${label.toLowerCase()}`, children: _jsx(Pencil, { size: 14, "aria-hidden": "true" }) })) : null, isEditing ? (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "tf-button-secondary tf-button-compact", onClick: () => setIsEditing(false), disabled: isEditingSaving, children: "Cancel" }), _jsx("button", { type: "submit", form: editFormId, className: "tf-button-primary tf-button-compact", disabled: isEditingSaving, children: "Save" })] })) : null] })] }), archiveConfirmationVisible && archiveState.mode === 'ready' ? (_jsx(PlanningArchiveConfirmation, { entityType: entityType, title: item.title, activeTaskCount: item.archiveActiveTaskCount, activeWorkstreamCount: item.archiveActiveWorkstreamCount, busy: archiveBusy, onCancel: () => setArchiveConfirmationVisible(false), onConfirm: () => void handleConfirmArchive() })) : null, relationshipContent, isEditing && onUpdate ? (_jsx(PlanningWorkspaceEditor, { entityType: entityType, mode: "edit", formId: editFormId, showActions: false, onSavingChange: setIsEditingSaving, initialTitle: item.title, initialDescription: item.description || '', onCancel: () => setIsEditing(false), onSave: async (input) => {
+                                    : _jsx(Archive, { size: 14, "aria-hidden": "true" }) })) : null, !isEditing && !item.isArchived && onUpdate ? (_jsx("button", { type: "button", className: "tf-control-icon", onClick: () => {
+                                    setIsEditingDirty(false);
+                                    setIsEditing(true);
+                                }, "aria-label": `Edit ${label.toLowerCase()}`, title: `Edit ${label.toLowerCase()}`, children: _jsx(Pencil, { size: 14, "aria-hidden": "true" }) })) : null, isEditing ? (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "tf-button-secondary tf-button-compact", onClick: () => setIsEditing(false), disabled: isEditingSaving, children: "Cancel" }), _jsx("button", { type: "submit", form: editFormId, className: "tf-button-primary tf-button-compact", disabled: isEditingSaving || !isEditingDirty, children: "Save" })] })) : null] })] }), archiveConfirmationVisible && archiveState.mode === 'ready' ? (_jsx(PlanningArchiveConfirmation, { entityType: entityType, title: item.title, activeTaskCount: item.archiveActiveTaskCount, activeWorkstreamCount: item.archiveActiveWorkstreamCount, busy: archiveBusy, onCancel: () => setArchiveConfirmationVisible(false), onConfirm: () => void handleConfirmArchive() })) : null, relationshipContent, isEditing && onUpdate ? (_jsx(PlanningWorkspaceEditor, { entityType: entityType, mode: "edit", formId: editFormId, showActions: false, onSavingChange: setIsEditingSaving, onDirtyChange: setIsEditingDirty, initialTitle: item.title, initialDescription: item.description || '', onCancel: () => setIsEditing(false), onSave: async (input) => {
                     await onUpdate(input);
                     setIsEditing(false);
                 } }, `${entityType}:${item.id}`)) : (_jsxs(_Fragment, { children: [_jsx("h3", { className: "tf-heading-card", children: item.title }), _jsx(PlanningEntityDescription, { description: item.description, label: label, taskReferences: taskReferences, className: `${styles.selectedEntityDescription} tf-scrollbar`.trim(), markdownClassName: styles.selectedEntityDescriptionMarkdown })] })), _jsxs("div", { className: styles.selectedEntityOwnerField, children: [_jsx("span", { children: "Owner" }), _jsx(PlanningOwnerDropdown, { value: ownerValue, options: ownerOptions, onChange: (nextOwnerId) => void handleOwnerChange(nextOwnerId), disabled: !onChangeOwner || Boolean(item.isArchived) || isSavingOwner, ariaLabel: `${label} owner`, className: `${planningDropdownStyles.control} ${styles.selectedEntityOwnerDropdown}` })] }), _jsx("div", { className: styles.selectedEntityDetailsSection, children: _jsx(PlanningEntityContext, { entityType: entityType, entityId: item.id, referenceLabel: entityType === 'initiative'

package/dist/components/features/planning/planningMetadata.d.ts

@@ -0,0 +1,10 @@
+export type PlanningMetadataDraft = {
+    title: string;
+    description?: string | null;
+};
+export declare function hasPlanningMetadataChanges(current: PlanningMetadataDraft, draft: PlanningMetadataDraft): boolean;
+export declare function hasWorkstreamMetadataChanges(current: PlanningMetadataDraft & {
+    initiativeId?: string | null;
+}, draft: PlanningMetadataDraft & {
+    initiativeId?: string | null;
+}): boolean;

package/dist/components/features/planning/planningMetadata.js

@@ -0,0 +1,8 @@
+export function hasPlanningMetadataChanges(current, draft) {
+    return draft.title.trim() !== current.title.trim()
+        || (draft.description?.trim() || null) !== (current.description?.trim() || null);
+}
+export function hasWorkstreamMetadataChanges(current, draft) {
+    return hasPlanningMetadataChanges(current, draft)
+        || (draft.initiativeId || null) !== (current.initiativeId || null);
+}

package/dist/components/features/taskforceAgentAssignments/AgentBehaviorAssignments.js

@@ -6,8 +6,8 @@ import { TASKFORCE_AGENT_SKILLS_MUTATED_EVENT, } from '../../../utils/taskforceA
 import taskforceStyles from '../../../Taskforce.module.css';
 import { loadAgentBehaviorCatalogs, } from './agentBehaviorCatalogApi.js';
 import styles from './AgentBehaviorAssignments.module.css';
-function revisionValue(reference) {
-    return reference.resolution === 'pinned' ? String(reference.revision ?? '') : '';
+function versionValue(reference) {
+    return reference.resolution === 'pinned' ? `revision:${String(reference.revision ?? '')}` : 'current';
 }
 function pinReference(reference, revision) {
     return {
@@ -45,6 +45,11 @@ function selectedRevision(value) {
     const numeric = Number(value);
     return Number.isInteger(numeric) && String(numeric) === value ? numeric : value;
 }
+function referenceForVersion(reference, value) {
+    if (value === 'current')
+        return currentReference(reference);
+    return pinReference(reference, selectedRevision(value.slice('revision:'.length)));
+}
 export function AgentBehaviorAssignments({ workspaceId, roleRef, skillRefs, onRoleRefChange, onSkillRefsChange, onManageRoles, onManageSkills, }) {
     const [roles, setRoles] = useState([]);
     const [skills, setSkills] = useState([]);
@@ -113,26 +118,18 @@ export function AgentBehaviorAssignments({ workspaceId, roleRef, skillRefs, onRo
             ...(roleRef.resolution === 'pinned'
                 && selectedRole
                 && !selectedRole.revisions.some((revision) => String(revision.revision) === String(roleRef.revision))
-                ? [`Pinned Role revision ${String(roleRef.revision)} is unavailable.`]
+                ? [`Role version ${String(roleRef.revision)} is unavailable.`]
                 : []),
         ]
         : [];
     return (_jsxs("div", { className: styles.assignments, children: [_jsxs("section", { className: styles.section, "aria-labelledby": "agent-role-heading", children: [_jsxs("div", { className: styles.sectionHeader, children: [_jsxs("div", { className: styles.sectionHeading, children: [_jsx(BriefcaseBusiness, { size: 17 }), _jsxs("div", { children: [_jsx("strong", { id: "agent-role-heading", children: "Role" }), _jsx("small", { children: "Optional reusable professional profile. An Agent can have one Role." })] })] }), _jsx("button", { type: "button", className: taskforceStyles.secondaryHeaderBtn, onClick: onManageRoles, children: "Manage Roles" })] }), _jsxs("div", { className: styles.roleControls, children: [_jsxs("label", { className: taskforceStyles.field, children: [_jsx("span", { className: taskforceStyles.label, children: "Role" }), _jsxs("select", { className: taskforceStyles.select, "aria-label": "Role", value: roleRef?.id || '', disabled: loading, onChange: (event) => {
                                             const id = event.target.value;
                                             onRoleRefChange(id ? { id, resolution: 'current' } : null);
-                                        }, children: [_jsx("option", { value: "", children: "No Role" }), roleRef && !selectedRole ? (_jsxs("option", { value: roleRef.id, children: ["Missing Role \u00B7 ", roleRef.id] })) : null, roles.map((role) => (_jsxs("option", { value: role.id, disabled: role.lifecycleStatus === 'retired', children: [role.definition.name, role.lifecycleStatus === 'retired' ? ' · Retired' : ''] }, role.id)))] })] }), _jsxs("label", { className: taskforceStyles.field, children: [_jsx("span", { className: taskforceStyles.label, children: "Version" }), _jsxs("select", { className: taskforceStyles.select, "aria-label": "Role version", value: roleRef?.resolution || 'current', disabled: !roleRef || !selectedRole, onChange: (event) => {
-                                            if (!roleRef || !selectedRole)
-                                                return;
-                                            if (event.target.value === 'current') {
-                                                onRoleRefChange(currentReference(roleRef));
-                                                return;
-                                            }
-                                            onRoleRefChange(pinReference(roleRef, selectedRole.currentRevision));
-                                        }, children: [_jsx("option", { value: "current", children: "Use latest" }), _jsx("option", { value: "pinned", children: "Pin revision" })] })] }), _jsxs("label", { className: taskforceStyles.field, children: [_jsx("span", { className: taskforceStyles.label, children: "Revision" }), _jsxs("select", { className: taskforceStyles.select, "aria-label": "Role pinned revision", value: roleRef ? revisionValue(roleRef) : '', disabled: !roleRef || roleRef.resolution !== 'pinned', onChange: (event) => {
+                                        }, children: [_jsx("option", { value: "", children: "No Role" }), roleRef && !selectedRole ? (_jsxs("option", { value: roleRef.id, children: ["Missing Role \u00B7 ", roleRef.id] })) : null, roles.map((role) => (_jsxs("option", { value: role.id, disabled: role.lifecycleStatus === 'retired', children: [role.definition.name, role.lifecycleStatus === 'retired' ? ' · Retired' : ''] }, role.id)))] })] }), _jsxs("label", { className: taskforceStyles.field, children: [_jsx("span", { className: taskforceStyles.label, children: "Version" }), _jsxs("select", { className: taskforceStyles.select, "aria-label": "Role version", value: roleRef ? versionValue(roleRef) : 'current', disabled: !roleRef || !selectedRole, onChange: (event) => {
                                             if (!roleRef)
                                                 return;
-                                            onRoleRefChange(pinReference(roleRef, selectedRevision(event.target.value)));
-                                        }, children: [_jsx("option", { value: "", children: "Current" }), roleRef ? availableRevisions(selectedRole, roleRef).map((revision) => (_jsxs("option", { value: revision, children: ["Revision ", revision] }, revision))) : null] })] })] }), selectedRole?.definition.shortDescription ? (_jsx("small", { className: styles.empty, children: selectedRole.definition.shortDescription })) : null, roleIssues.map((message) => (_jsxs("div", { className: styles.issue, role: "alert", children: [_jsx(AlertTriangle, { size: 13 }), _jsxs("span", { children: [message, " Agent execution is blocked until this reference is repaired."] })] }, message)))] }), _jsxs("section", { className: styles.section, "aria-labelledby": "agent-skills-heading", children: [_jsxs("div", { className: styles.sectionHeader, children: [_jsxs("div", { className: styles.sectionHeading, children: [_jsx(Sparkles, { size: 17 }), _jsxs("div", { children: [_jsx("strong", { id: "agent-skills-heading", children: "Skills" }), _jsx("small", { children: "Composable behavior applied in this exact order. Later Skills take precedence when guidance conflicts." })] })] }), _jsx("button", { type: "button", className: taskforceStyles.secondaryHeaderBtn, onClick: onManageSkills, children: "Manage Skills" })] }), _jsxs("div", { className: styles.skillAdd, children: [_jsxs("label", { className: taskforceStyles.field, children: [_jsx("span", { className: taskforceStyles.label, children: "Add Skill" }), _jsxs("select", { className: taskforceStyles.select, "aria-label": "Skill to add", value: skillToAdd, disabled: loading || activeSkillsToAdd.length === 0, onChange: (event) => setSkillToAdd(event.target.value), children: [_jsx("option", { value: "", children: "Select a Skill" }), activeSkillsToAdd.map((skill) => (_jsx("option", { value: skill.id, children: skill.definition.name }, skill.id)))] })] }), _jsx("button", { type: "button", className: "tf-control-icon", disabled: !skillToAdd, "aria-label": "Add selected Skill", title: "Add selected Skill", onClick: () => {
+                                            onRoleRefChange(referenceForVersion(roleRef, event.target.value));
+                                        }, children: [_jsx("option", { value: "current", children: selectedRole ? `Use latest (Version ${selectedRole.currentRevision})` : 'Use latest' }), roleRef ? availableRevisions(selectedRole, roleRef).map((revision) => (_jsxs("option", { value: `revision:${String(revision)}`, children: ["Version ", revision] }, revision))) : null] })] })] }), selectedRole?.definition.shortDescription ? (_jsx("small", { className: styles.empty, children: selectedRole.definition.shortDescription })) : null, roleIssues.map((message) => (_jsxs("div", { className: styles.issue, role: "alert", children: [_jsx(AlertTriangle, { size: 13 }), _jsxs("span", { children: [message, " Agent execution is blocked until this reference is repaired."] })] }, message)))] }), _jsxs("section", { className: styles.section, "aria-labelledby": "agent-skills-heading", children: [_jsxs("div", { className: styles.sectionHeader, children: [_jsxs("div", { className: styles.sectionHeading, children: [_jsx(Sparkles, { size: 17 }), _jsxs("div", { children: [_jsx("strong", { id: "agent-skills-heading", children: "Skills" }), _jsx("small", { children: "Composable behavior applied in this exact order. Later Skills take precedence when guidance conflicts." })] })] }), _jsx("button", { type: "button", className: taskforceStyles.secondaryHeaderBtn, onClick: onManageSkills, children: "Manage Skills" })] }), _jsxs("div", { className: styles.skillAdd, children: [_jsxs("label", { className: taskforceStyles.field, children: [_jsx("span", { className: taskforceStyles.label, children: "Add Skill" }), _jsxs("select", { className: taskforceStyles.select, "aria-label": "Skill to add", value: skillToAdd, disabled: loading || activeSkillsToAdd.length === 0, onChange: (event) => setSkillToAdd(event.target.value), children: [_jsx("option", { value: "", children: "Select a Skill" }), activeSkillsToAdd.map((skill) => (_jsx("option", { value: skill.id, children: skill.definition.name }, skill.id)))] })] }), _jsx("button", { type: "button", className: "tf-control-icon", disabled: !skillToAdd, "aria-label": "Add selected Skill", title: "Add selected Skill", onClick: () => {
                                     if (!skillToAdd || selectedSkillIds.has(skillToAdd))
                                         return;
                                     onSkillRefsChange([...skillRefs, { id: skillToAdd, resolution: 'current' }]);
@@ -145,20 +142,14 @@ export function AgentBehaviorAssignments({ workspaceId, roleRef, skillRefs, onRo
                                 ...(reference.resolution === 'pinned'
                                     && skill
                                     && !skill.revisions.some((revision) => String(revision.revision) === String(reference.revision))
-                                    ? [`Pinned Skill revision ${String(reference.revision)} is unavailable.`]
+                                    ? [`Skill version ${String(reference.revision)} is unavailable.`]
                                     : []),
                             ];
-                            return (_jsxs("li", { children: [_jsxs("div", { className: styles.referenceRow, children: [_jsxs("div", { className: styles.referenceCopy, children: [_jsxs("strong", { children: [index + 1, ". ", skill?.definition.name || `Missing Skill · ${reference.id}`] }), _jsx("small", { children: skill?.definition.shortDescription || reference.id })] }), _jsxs("select", { className: taskforceStyles.select, "aria-label": `${skill?.definition.name || reference.id} version`, value: reference.resolution, disabled: !skill, onChange: (event) => {
-                                                    const next = [...skillRefs];
-                                                    next[index] = event.target.value === 'current'
-                                                        ? currentReference(reference)
-                                                        : pinReference(reference, skill?.revision || 1);
-                                                    onSkillRefsChange(next);
-                                                }, children: [_jsx("option", { value: "current", children: "Use latest" }), _jsx("option", { value: "pinned", children: "Pin revision" })] }), _jsxs("select", { className: taskforceStyles.select, "aria-label": `${skill?.definition.name || reference.id} pinned revision`, value: revisionValue(reference), disabled: reference.resolution !== 'pinned', onChange: (event) => {
+                            return (_jsxs("li", { children: [_jsxs("div", { className: styles.referenceRow, children: [_jsxs("div", { className: styles.referenceCopy, children: [_jsxs("strong", { children: [index + 1, ". ", skill?.definition.name || `Missing Skill · ${reference.id}`] }), _jsx("small", { children: skill?.definition.shortDescription || reference.id })] }), _jsxs("select", { className: taskforceStyles.select, "aria-label": `${skill?.definition.name || reference.id} version`, value: versionValue(reference), disabled: !skill, onChange: (event) => {
                                                     const next = [...skillRefs];
-                                                    next[index] = pinReference(reference, selectedRevision(event.target.value));
+                                                    next[index] = referenceForVersion(reference, event.target.value);
                                                     onSkillRefsChange(next);
-                                                }, children: [_jsx("option", { value: "", children: "Current" }), availableRevisions(skill, reference).map((revision) => (_jsxs("option", { value: revision, children: ["Revision ", revision] }, revision)))] }), _jsxs("div", { className: styles.rowActions, children: [_jsx("button", { type: "button", className: "tf-control-icon tf-control-icon-compact", "aria-label": `Move ${skill?.definition.name || reference.id} up`, disabled: index === 0, onClick: () => {
+                                                }, children: [_jsx("option", { value: "current", children: skill ? `Use latest (Version ${skill.revision})` : 'Use latest' }), availableRevisions(skill, reference).map((revision) => (_jsxs("option", { value: `revision:${String(revision)}`, children: ["Version ", revision] }, revision)))] }), _jsxs("div", { className: styles.rowActions, children: [_jsx("button", { type: "button", className: "tf-control-icon tf-control-icon-compact", "aria-label": `Move ${skill?.definition.name || reference.id} up`, disabled: index === 0, onClick: () => {
                                                             if (index === 0)
                                                                 return;
                                                             const next = [...skillRefs];

package/dist/components/features/taskforceAgentEditorModel.d.ts

@@ -1,5 +1,5 @@
 import { type AgentDefinitionV1, type BehaviorReference } from '../../shared/taskforceAgentDefinition.js';
-import { type TaskforceAgentProviderKey } from '../../shared/taskforceAgentModels.js';
+import { type TaskforceAgentProviderKey, type TaskforceAgentConnectionScope } from '../../shared/taskforceAgentModels.js';
 import type { ModelGatewayTier } from '../../services/modelGateway.js';
 export declare const PERSONALITY_PRESETS: readonly [{
     readonly key: "practical";
@@ -104,6 +104,7 @@ export declare function buildTaskforceAgentDefinitionFromDraft(input: {
     providerKey: TaskforceAgentProviderKey;
     modelKey: string;
     tier: ModelGatewayTier;
+    connectionScope?: TaskforceAgentConnectionScope;
 }): AgentDefinitionV1;
 export declare function hasUnsavedAvatarPresentation(definition: AgentDefinitionV1 | null | undefined, draft: TaskforceAgentEditorDraft): boolean;
 export {};

package/dist/components/features/taskforceAgentEditorModel.js

@@ -107,7 +107,9 @@ export function buildTaskforceAgentDefinitionFromDraft(input) {
             modelKey: input.modelKey,
             modelSource: selectedModel?.source || 'bedrock',
             tier: input.tier,
-            ...(selectedModel?.source === 'subscription_dev' ? { connectionScope: 'local_dev' } : {}),
+            ...(selectedModel?.source === 'subscription_dev'
+                ? { connectionScope: input.connectionScope || 'local_dev' }
+                : {}),
         },
         behavior: {
             ...(personality ? { personality } : {}),

package/dist/components/features/workflowManager/workflowManagerApi.d.ts

@@ -14,7 +14,7 @@ export declare function getTaskWorkflowAssignment(taskId: string, context?: Work
 export type WorkflowCompletionProjection = {
     executionId: string;
     taskId: string;
-    assignmentSnapshot: unknown;
+    assignmentSnapshot: WorkflowAssignmentDetails;
     taskSnapshot?: TaskItem | null;
     taskAuthoritative?: unknown;
 };

package/dist/components/features/workflowManager/workflowManagerApi.js

@@ -80,6 +80,9 @@ export async function completeCurrentWorkflowStep(executionId, idempotencyKey, c
             taskId: payload.result.taskSnapshot.id,
             reason: 'workflow-step',
             ...(installedTask ? { authoritativeTask: installedTask } : {}),
+            ...(payload.result.assignmentSnapshot
+                ? { authoritativeWorkflowAssignment: payload.result.assignmentSnapshot }
+                : {}),
         });
     }
     return payload.result;

package/dist/components/task/TaskWorkflowAssignmentField.js

@@ -11,6 +11,40 @@ const NO_WORKFLOW = '__none__';
 function statusLabel(status) {
     return status.charAt(0).toUpperCase() + status.slice(1);
 }
+function workflowAssignmentFromMutation(value, taskId) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const assignment = value;
+    if (!assignment.execution
+        || assignment.execution.taskId !== taskId
+        || !assignment.template
+        || !assignment.version
+        || !Array.isArray(assignment.steps)
+        || !Array.isArray(assignment.events))
+        return null;
+    return assignment;
+}
+function latestWorkflowEventSequence(assignment) {
+    return Math.max(0, ...(assignment?.events || []).map((event) => event.sequenceNumber || 0));
+}
+function workflowExecutionCreatedAt(assignment) {
+    const timestamp = Date.parse(assignment.execution.createdAt);
+    return Number.isFinite(timestamp) ? timestamp : 0;
+}
+function newerWorkflowAssignment(current, candidate) {
+    if (!candidate)
+        return current;
+    if (!current)
+        return candidate;
+    if (current.execution.id !== candidate.execution.id) {
+        return workflowExecutionCreatedAt(candidate) > workflowExecutionCreatedAt(current)
+            ? candidate
+            : current;
+    }
+    return latestWorkflowEventSequence(candidate) >= latestWorkflowEventSequence(current)
+        ? candidate
+        : current;
+}
 export function TaskWorkflowAssignmentField({ taskId, workspaceId, taskStatus, taskUpdatedAt, comments = [], assigneeOptions = [], currentActorId, apiBaseUrl, runtimeMode = 'local', disabled = false, onActivatePendingWorkflow, onActiveOwnerChange, }) {
     const [workflows, setWorkflows] = React.useState([]);
     const [assignment, setAssignment] = React.useState(null);
@@ -21,6 +55,7 @@ export function TaskWorkflowAssignmentField({ taskId, workspaceId, taskStatus, t
     const [activationRetryToken, setActivationRetryToken] = React.useState(0);
     const [error, setError] = React.useState('');
     const requestGenerationRef = React.useRef(0);
+    const assignmentRefreshGenerationRef = React.useRef(0);
     const activationAttemptRef = React.useRef(null);
     const refreshedTaskRevisionRef = React.useRef({
         taskId,
@@ -29,6 +64,7 @@ export function TaskWorkflowAssignmentField({ taskId, workspaceId, taskStatus, t
     const requestContext = React.useMemo(() => ({ workspaceId, apiBaseUrl, runtimeMode }), [apiBaseUrl, runtimeMode, workspaceId]);
     React.useEffect(() => {
         const requestGeneration = ++requestGenerationRef.current;
+        const assignmentRefreshGeneration = ++assignmentRefreshGenerationRef.current;
         setLoading(true);
         setAssigning(false);
         setCompletingStep(false);
@@ -47,18 +83,23 @@ export function TaskWorkflowAssignmentField({ taskId, workspaceId, taskStatus, t
             if (workflowResult.status === 'fulfilled') {
                 setWorkflows(workflowResult.value.filter((summary) => (summary.template.status === 'active' && Boolean(summary.latestPublishedVersion))));
             }
-            if (assignmentResult.status === 'fulfilled') {
-                setAssignment(assignmentResult.value);
-            }
-            if (assignmentResult.status === 'rejected') {
-                setError(String(assignmentResult.reason?.message || 'Unable to load workflow assignment.'));
-            }
-            else if (!assignmentResult.value && workflowResult.status === 'rejected') {
-                setError(String(workflowResult.reason?.message || 'Unable to load workflows.'));
+            if (assignmentRefreshGeneration === assignmentRefreshGenerationRef.current) {
+                if (assignmentResult.status === 'fulfilled') {
+                    setAssignment(assignmentResult.value);
+                    if (!assignmentResult.value && workflowResult.status === 'rejected') {
+                        setError(String(workflowResult.reason?.message || 'Unable to load workflows.'));
+                    }
+                }
+                else {
+                    setError(String(assignmentResult.reason?.message || 'Unable to load workflow assignment.'));
+                }
             }
             setLoading(false);
         });
-        return () => { requestGenerationRef.current += 1; };
+        return () => {
+            requestGenerationRef.current += 1;
+            assignmentRefreshGenerationRef.current += 1;
+        };
     }, [requestContext, taskId]);
     const latestAssignment = assignment?.execution.taskId === taskId ? assignment : null;
     const hasActiveExecution = latestAssignment
@@ -186,13 +227,18 @@ export function TaskWorkflowAssignmentField({ taskId, workspaceId, taskStatus, t
             return;
         refreshedTaskRevisionRef.current = { taskId, revision: taskRevision };
         const requestGeneration = requestGenerationRef.current;
+        const assignmentRefreshGeneration = ++assignmentRefreshGenerationRef.current;
         void getTaskWorkflowAssignment(taskId, requestContext).then((nextAssignment) => {
             if (requestGeneration !== requestGenerationRef.current)
                 return;
+            if (assignmentRefreshGeneration !== assignmentRefreshGenerationRef.current)
+                return;
             setAssignment(nextAssignment);
         }).catch((requestError) => {
             if (requestGeneration !== requestGenerationRef.current)
                 return;
+            if (assignmentRefreshGeneration !== assignmentRefreshGenerationRef.current)
+                return;
             setError(String(requestError?.message || 'Unable to refresh workflow assignment.'));
         });
     }, [isPending, requestContext, taskId, taskStatus, taskUpdatedAt]);
@@ -210,15 +256,27 @@ export function TaskWorkflowAssignmentField({ taskId, workspaceId, taskStatus, t
             const eventTaskId = String(detail.taskId || '').trim();
             if (eventTaskId !== taskId)
                 return;
-            const requestGeneration = ++requestGenerationRef.current;
+            const authoritativeAssignment = workflowAssignmentFromMutation(detail.authoritativeWorkflowAssignment, taskId);
+            if (authoritativeAssignment) {
+                ++assignmentRefreshGenerationRef.current;
+                setAssignment((current) => newerWorkflowAssignment(current, authoritativeAssignment));
+                setError('');
+                return;
+            }
+            const requestGeneration = requestGenerationRef.current;
+            const assignmentRefreshGeneration = ++assignmentRefreshGenerationRef.current;
             void getTaskWorkflowAssignment(taskId, requestContext).then((nextAssignment) => {
                 if (requestGeneration !== requestGenerationRef.current)
                     return;
+                if (assignmentRefreshGeneration !== assignmentRefreshGenerationRef.current)
+                    return;
                 setAssignment(nextAssignment);
                 setError('');
             }).catch((requestError) => {
                 if (requestGeneration !== requestGenerationRef.current)
                     return;
+                if (assignmentRefreshGeneration !== assignmentRefreshGenerationRef.current)
+                    return;
                 setError(String(requestError?.message || 'Unable to refresh workflow assignment.'));
             });
         };