@bbigbang/core 0.1.0

package/dist/services/platformAgentPolicy.js

@@ -0,0 +1,180 @@
+export const BUILTIN_PLATFORM_AGENT_DEFINITION_IDS = ['suggested_planner', 'library_curator'];
+const PLATFORM_WORKFLOW_CATALOG = {
+    planner_suggestions: {
+        workflowType: 'planner_suggestions',
+        label: 'Planner Suggestions',
+        description: 'Reviews operational context and proposes concrete follow-up opportunities.',
+        defaultResourceScopes: ['open_tasks', 'saved_inbox', 'recent_messages', 'conversation_summaries'],
+        defaultToolPolicy: { disabledToolKinds: ['edit', 'execute', 'fetch', 'switch_mode', 'other'] },
+        defaultPromptTemplate: [
+            'You review the provided platform resource bundle and identify concrete next-work opportunities.',
+            'Focus on actionable follow-up, missing ownership, stale tasks, and saved items that should become tracked work.',
+            'Return structured suggestions only.',
+            'Do not create tasks directly.',
+        ].join('\n'),
+    },
+    library_curate: {
+        workflowType: 'library_curate',
+        label: 'Library Curate',
+        description: 'Organizes saved information into a personal markdown library.',
+        defaultResourceScopes: ['saved_inbox', 'personal_library_inventory', 'personal_library_documents'],
+        defaultToolPolicy: { disabledToolKinds: ['edit', 'delete', 'move', 'execute', 'fetch', 'switch_mode', 'other'] },
+        defaultPromptTemplate: [
+            'You organize saved information into a personal document library.',
+            'Prefer updating existing documents before creating new ones.',
+            'Return a structured document plan only.',
+            'Do not rename, move, or delete documents.',
+        ].join('\n'),
+    },
+};
+const BUILTIN_PLATFORM_DEFINITIONS = {
+    suggested_planner: {
+        workflowType: 'planner_suggestions',
+        label: 'Suggested Planner',
+        description: 'Reviews tasks, summaries, saved inbox, and recent messages to propose next work.',
+    },
+    library_curator: {
+        workflowType: 'library_curate',
+        label: 'Library Curator',
+        description: 'Organizes saved messages into structured markdown documents.',
+    },
+};
+export function isPlatformAgentRole(role) {
+    return role === 'platform_agent' || role === 'library_curator' || role === 'suggested_planner';
+}
+export function isBuiltinPlatformAgentDefinitionId(value) {
+    return value === 'suggested_planner' || value === 'library_curator';
+}
+export function getBuiltinPlatformDefinition(params) {
+    const base = BUILTIN_PLATFORM_DEFINITIONS[params.definitionId];
+    const workflow = getPlatformWorkflowCatalogEntry(base.workflowType);
+    return {
+        definitionId: params.definitionId,
+        workflowType: base.workflowType,
+        label: base.label,
+        description: base.description,
+        resourceScopes: [...workflow.defaultResourceScopes],
+        resourceConfig: {},
+        promptTemplateOverride: null,
+        toolPolicy: { ...workflow.defaultToolPolicy },
+        enabled: true,
+        createdAt: params.createdAt ?? 0,
+        updatedAt: params.updatedAt ?? 0,
+    };
+}
+export function getPlatformWorkflowCatalog() {
+    return Object.values(PLATFORM_WORKFLOW_CATALOG).map((entry) => ({
+        ...entry,
+        defaultResourceScopes: [...entry.defaultResourceScopes],
+        defaultToolPolicy: {
+            disabledToolKinds: [...(entry.defaultToolPolicy.disabledToolKinds ?? [])],
+        },
+    }));
+}
+export function getPlatformWorkflowCatalogEntry(workflowType) {
+    const entry = PLATFORM_WORKFLOW_CATALOG[workflowType];
+    return {
+        ...entry,
+        defaultResourceScopes: [...entry.defaultResourceScopes],
+        defaultToolPolicy: {
+            disabledToolKinds: [...(entry.defaultToolPolicy.disabledToolKinds ?? [])],
+        },
+    };
+}
+export function getPlatformAgentDisabledToolKinds(definitionId) {
+    const workflowType = isBuiltinPlatformAgentDefinitionId(definitionId)
+        ? BUILTIN_PLATFORM_DEFINITIONS[definitionId].workflowType
+        : null;
+    if (!workflowType)
+        return [];
+    return [...(getPlatformWorkflowCatalogEntry(workflowType).defaultToolPolicy.disabledToolKinds ?? [])];
+}
+export function normalizePlatformAgentToolPolicy(workflowType, policy) {
+    const fallback = getPlatformWorkflowCatalogEntry(workflowType).defaultToolPolicy;
+    const requested = Array.isArray(policy?.disabledToolKinds)
+        ? policy.disabledToolKinds.filter((kind) => typeof kind === 'string')
+        : [];
+    const required = fallback.disabledToolKinds ?? [];
+    const disabled = [...new Set([...required, ...requested])];
+    return disabled.length > 0 ? { disabledToolKinds: disabled } : {};
+}
+export function normalizePlatformResourceScopes(workflowType, scopes) {
+    const allowed = new Set([
+        'saved_inbox',
+        'open_tasks',
+        'recent_messages',
+        'conversation_summaries',
+        'agent_memory',
+        'agent_notes',
+        'personal_library_inventory',
+        'personal_library_documents',
+    ]);
+    const values = Array.isArray(scopes)
+        ? scopes.filter((scope) => typeof scope === 'string' && allowed.has(scope))
+        : [];
+    if (values.length > 0)
+        return [...new Set(values)];
+    return getPlatformWorkflowCatalogEntry(workflowType).defaultResourceScopes;
+}
+export function getPlatformAgentConversationTitle(params) {
+    return `[platform:${params.definitionId}:${params.mode}]`;
+}
+export function parsePlatformConversationTitle(title) {
+    const trimmed = title?.trim();
+    if (!trimmed?.startsWith('[platform:') || !trimmed.endsWith(']'))
+        return null;
+    const body = trimmed.slice('[platform:'.length, -1);
+    const splitAt = body.lastIndexOf(':');
+    if (splitAt <= 0)
+        return null;
+    const definitionId = body.slice(0, splitAt).trim();
+    const mode = body.slice(splitAt + 1).trim();
+    if (!definitionId || (mode !== 'workflow' && mode !== 'debug'))
+        return null;
+    return { definitionId, mode };
+}
+export function getPlatformDirectReplyScope(title) {
+    const parsed = parsePlatformConversationTitle(title);
+    return parsed ? `platform:${parsed.definitionId}:${parsed.mode}` : null;
+}
+export function getPlatformAgentLegacyConversationTitles(definitionId) {
+    if (definitionId === 'suggested_planner')
+        return ['', 'Suggested Planner'];
+    if (definitionId === 'library_curator')
+        return ['', 'Library Curator'];
+    return [];
+}
+export function buildPlatformAgentSystemPrompt(params) {
+    const header = [
+        '[Platform agent contract]',
+        `Agent: ${params.agentName}`,
+        `Definition: ${params.definitionId}`,
+        `Workflow type: ${params.workflowType}`,
+        `Run mode: ${params.mode}`,
+        `Workspace: ${params.workspacePath}`,
+        'You are a hidden product workflow agent, not an ordinary chat assistant.',
+        'Use only the provided workflow contract and resource snapshot for reasoning.',
+    ];
+    if (params.workflowType === 'planner_suggestions') {
+        return [
+            ...header,
+            params.mode === 'workflow'
+                ? 'This is a workflow run. Return only the structured planner JSON output requested by the current prompt.'
+                : 'This is a debug run. You may inspect inputs and explain reasoning, but do not create or refresh durable planner suggestions, tasks, or other product state.',
+            'Do not act like a user-facing DM agent.',
+            'Do not claim tasks or create tasks directly.',
+            'End debug runs with one concise visible diagnostic reply in plain assistant text.',
+            'Prefer concise, operational output over conversational filler.',
+        ].join('\n');
+    }
+    return [
+        ...header,
+        params.mode === 'workflow'
+            ? 'This is a workflow run. Return only the structured document-plan JSON requested by the current prompt.'
+            : 'This is a debug run. You may inspect and discuss organization, but do not mutate durable library state, manifest/index state, or saved-item processing state.',
+        'Do not act like a user-facing DM agent.',
+        'Do not rename, move, or delete user documents unless a future workflow contract explicitly allows it.',
+        'End debug runs with one concise visible diagnostic reply in plain assistant text.',
+        'Prefer disciplined document-management behavior over free-form experimentation.',
+    ].join('\n');
+}