@themoltnet/pi-extension 0.20.0 → 0.20.1

package/dist/index.js

@@ -1130,84 +1130,6 @@ var searchDiary = (options) => (options?.client ?? client).post({
 	}
 });
 /**
-* Get a digest of recent diary entries.
-*/
-var reflectDiary = (options) => (options.client ?? client).get({
-	security: [
-		{
-			scheme: "bearer",
-			type: "http"
-		},
-		{
-			name: "X-Moltnet-Session-Token",
-			type: "apiKey"
-		},
-		{
-			in: "cookie",
-			name: "ory_kratos_session",
-			type: "apiKey"
-		}
-	],
-	url: "/diaries/reflect",
-	...options
-});
-/**
-* [DEPRECATED] Server-side consolidation is obsolete. Compose consolidation suggestions client-side using diary search + clustering. Cluster semantically similar entries and return consolidation suggestions.
-*
-* @deprecated
-*/
-var consolidateDiary = (options) => (options.client ?? client).post({
-	security: [
-		{
-			scheme: "bearer",
-			type: "http"
-		},
-		{
-			name: "X-Moltnet-Session-Token",
-			type: "apiKey"
-		},
-		{
-			in: "cookie",
-			name: "ory_kratos_session",
-			type: "apiKey"
-		}
-	],
-	url: "/diaries/{id}/consolidate",
-	...options,
-	headers: {
-		"Content-Type": "application/json",
-		...options.headers
-	}
-});
-/**
-* [DEPRECATED] Server-side compilation is obsolete. Use POST /diaries/:id/packs to create custom packs from agent-side entry selection. Compile a token-budget-fitted context pack from diary entries.
-*
-* @deprecated
-*/
-var compileDiary = (options) => (options.client ?? client).post({
-	security: [
-		{
-			scheme: "bearer",
-			type: "http"
-		},
-		{
-			name: "X-Moltnet-Session-Token",
-			type: "apiKey"
-		},
-		{
-			in: "cookie",
-			name: "ory_kratos_session",
-			type: "apiKey"
-		}
-	],
-	url: "/diaries/{id}/compile",
-	...options,
-	headers: {
-		"Content-Type": "application/json",
-		...options.headers
-	}
-});
-/**
 * Export the provenance graph for a persisted context pack by ID.
 */
 var getContextPackProvenanceById = (options) => (options.client ?? client).get({
@@ -2683,22 +2605,6 @@ function createDiariesNamespace(context) {
 				path: { id }
 			}));
 		},
-		async consolidate(id, body) {
-			return unwrapResult(await consolidateDiary({
-				client,
-				auth,
-				path: { id },
-				body
-			}));
-		},
-		async compile(id, body) {
-			return unwrapResult(await compileDiary({
-				client,
-				auth,
-				path: { id },
-				body
-			}));
-		},
 		async tags(diaryId, query) {
 			return unwrapResult(await listDiaryTags({
 				client,
@@ -4546,13 +4452,6 @@ function createEntriesNamespace(context) {
 				body
 			}));
 		},
-		async reflect(query) {
-			return unwrapResult(await reflectDiary({
-				client,
-				auth,
-				query
-			}));
-		},
 		async verify(entryId) {
 			return unwrapResult(await verifyDiaryEntryById({
 				client,
@@ -8032,7 +7931,7 @@ function createMoltNetTools(config) {
 		defineTool({
 			name: "moltnet_host_exec",
 			label: "Run command on host (escape hatch — requires user approval)",
-			description: "Runs a command on the HOST machine, outside the sandbox VM. The user will be prompted to approve each invocation via a UI dialog — do NOT call this tool speculatively. Use ONLY when a sandboxed operation is impossible — e.g. `git push`, `gh pr create`.\n\nAllowed executables: git, gh, moltnet. Runs with a minimal env (PATH, HOME, GIT_CONFIG_GLOBAL, …); pass any additional vars via the `env` parameter (e.g. GH_TOKEN). Every invocation is logged as an auditable host execution.",
+			description: "Runs a command on the HOST machine, outside the sandbox VM. The user will be prompted to approve each invocation via a UI dialog, and in headless task runs there is no one to approve — so do NOT call this tool speculatively. Routine git and gh work — pushing branches, opening pull requests, etc. — runs INSIDE the VM via the normal `bash` tool, where your credentials are already injected; use that, not this escape hatch. Reserve this tool for the rare case that genuinely cannot run in the guest (e.g. reaching a host-only resource the VM has no path to).\n\nAllowed executables: git, gh, moltnet. Runs with a minimal env (PATH, HOME, GIT_CONFIG_GLOBAL, …); pass any additional vars via the `env` parameter (e.g. GH_TOKEN). Every invocation is logged as an auditable host execution.",
 			parameters: Type.Object({
 				executable: Type.String({ description: "Executable to run (git | gh | moltnet)" }),
 				args: Type.Array(Type.String(), { description: "Arguments to pass to the executable" }),
@@ -9477,6 +9376,59 @@ var CuratePackOutput = Type$1.Object({
 	additionalProperties: false
 });
 //#endregion
+//#region ../tasks/src/task-types/freeform.ts
+var FREEFORM_TYPE = "freeform";
+var FreeformTaskTypeProposal = Type$1.Object({
+	name: Type$1.String({ minLength: 1 }),
+	rationale: Type$1.String({ minLength: 1 }),
+	inputShape: Type$1.Optional(Type$1.Record(Type$1.String(), Type$1.Unknown())),
+	outputShape: Type$1.Optional(Type$1.Record(Type$1.String(), Type$1.Unknown()))
+}, {
+	$id: "FreeformTaskTypeProposal",
+	additionalProperties: false
+});
+var FreeformInput = Type$1.Object({
+	title: Type$1.Optional(Type$1.String({ minLength: 1 })),
+	brief: Type$1.String({ minLength: 1 }),
+	expectedOutput: Type$1.Optional(Type$1.String({ minLength: 1 })),
+	constraints: Type$1.Optional(Type$1.Array(Type$1.String({ minLength: 1 }), { maxItems: 20 })),
+	suggestedTaskType: Type$1.Optional(Type$1.String({ minLength: 1 })),
+	successCriteria: Type$1.Optional(SuccessCriteria),
+	context: Type$1.Optional(TaskContext)
+}, {
+	$id: "FreeformInput",
+	additionalProperties: false
+});
+var FreeformArtifact = Type$1.Object({
+	kind: Type$1.String({ minLength: 1 }),
+	title: Type$1.String({ minLength: 1 }),
+	description: Type$1.Optional(Type$1.String({ minLength: 1 })),
+	url: Type$1.Optional(Type$1.String({ minLength: 1 })),
+	path: Type$1.Optional(Type$1.String({ minLength: 1 }))
+}, {
+	$id: "FreeformArtifact",
+	additionalProperties: false
+});
+var FreeformFollowUpTask = Type$1.Object({
+	title: Type$1.String({ minLength: 1 }),
+	brief: Type$1.String({ minLength: 1 }),
+	suggestedTaskType: Type$1.Optional(Type$1.String({ minLength: 1 }))
+}, {
+	$id: "FreeformFollowUpTask",
+	additionalProperties: false
+});
+var FreeformOutput = Type$1.Object({
+	summary: Type$1.String({ minLength: 1 }),
+	artifacts: Type$1.Optional(Type$1.Array(FreeformArtifact, { maxItems: 20 })),
+	proposedTaskType: Type$1.Optional(FreeformTaskTypeProposal),
+	followUpTasks: Type$1.Optional(Type$1.Array(FreeformFollowUpTask, { maxItems: 20 })),
+	diaryEntryIds: Type$1.Optional(Type$1.Array(Type$1.String({ format: "uuid" }))),
+	verification: Type$1.Optional(VerificationRecord)
+}, {
+	$id: "FreeformOutput",
+	additionalProperties: false
+});
+//#endregion
 //#region ../tasks/src/task-types/fulfill-brief.ts
 /**
 * `fulfill_brief` — produce a signed change against a coding brief.
@@ -10035,6 +9987,16 @@ function requireVerificationWhenCriteriaPresent(output, input) {
 * / claiming a task.
 */
 var BUILT_IN_TASK_TYPES = {
+	[FREEFORM_TYPE]: {
+		name: FREEFORM_TYPE,
+		inputSchema: FreeformInput,
+		outputSchema: FreeformOutput,
+		outputKind: "artifact",
+		workspaceScope: "attempt",
+		sessionScope: "none",
+		requiresReferences: false,
+		validateOutput: requireVerificationWhenCriteriaPresent
+	},
 	[FULFILL_BRIEF_TYPE]: {
 		name: FULFILL_BRIEF_TYPE,
 		inputSchema: FulfillBriefInput,
@@ -10967,6 +10929,97 @@ function buildCuratePackUserPrompt(input, ctx) {
 	]);
 }
 //#endregion
+//#region ../agent-runtime/src/prompts/freeform.ts
+function buildFreeformUserPrompt(input, ctx) {
+	const header = [
+		"# Freeform Task Agent",
+		"",
+		"You are handling an exploratory MoltNet task that does not yet have a",
+		"more specific execution contract. Treat the brief as the source of truth,",
+		"use judgment, and keep the result useful enough for a human or another",
+		"agent to continue from it.",
+		"",
+		`Task id: \`${ctx.taskId}\``
+	].join("\n");
+	const expectedOutput = input.expectedOutput ?? "";
+	const constraints = input.constraints?.length ? input.constraints.map((constraint) => `- ${constraint}`).join("\n") : "";
+	const suggestedTaskType = input.suggestedTaskType ? [`The proposer suggested task type \`${input.suggestedTaskType}\`.`, "Use it as a hint, not as a contract."].join("\n") : "";
+	const workflow = [
+		"1. Clarify the real objective from the brief before acting.",
+		"2. Gather enough context to avoid guessing.",
+		"3. Complete the requested work when it is safe and bounded.",
+		"4. If the request reveals a recurring task shape, include a",
+		"   `proposedTaskType` in the final output with a concise rationale.",
+		"5. If the work should be split or continued, include `followUpTasks`."
+	].join("\n");
+	return assembleTaskPrompt("freeform", [
+		{
+			id: "freeform.header",
+			source: "header",
+			body: header
+		},
+		{
+			id: "freeform.title",
+			source: "task_input",
+			header: "Title",
+			body: input.title ?? ""
+		},
+		{
+			id: "freeform.brief",
+			source: "task_input",
+			header: "Brief",
+			body: input.brief
+		},
+		{
+			id: "freeform.expected_output",
+			source: "task_input",
+			header: "Expected Output",
+			body: expectedOutput
+		},
+		{
+			id: "freeform.constraints",
+			source: "task_input",
+			header: "Constraints",
+			body: constraints
+		},
+		{
+			id: "freeform.suggested_task_type",
+			source: "task_input",
+			header: "Suggested Task Type",
+			body: suggestedTaskType
+		},
+		{
+			id: "freeform.workflow",
+			source: "static",
+			header: "Workflow",
+			body: workflow
+		},
+		{
+			id: "freeform.verification",
+			source: "verification",
+			body: buildSelfVerificationBlock(ctx.taskId)
+		},
+		{
+			id: "freeform.final_output",
+			source: "final_output",
+			body: buildFinalOutputBlock({
+				taskType: "freeform",
+				outputSchemaName: "FreeformOutput",
+				shapeSketch: [
+					"{",
+					"  \"summary\": \"<2-5 sentence result>\",",
+					"  \"artifacts\": [{ \"kind\": \"...\", \"title\": \"...\", \"description\": \"...\", \"url\": \"...\", \"path\": \"...\" }],",
+					"  \"proposedTaskType\": { \"name\": \"...\", \"rationale\": \"...\", \"inputShape\": {}, \"outputShape\": {} },",
+					"  \"followUpTasks\": [{ \"title\": \"...\", \"brief\": \"...\", \"suggestedTaskType\": \"...\" }],",
+					"  \"diaryEntryIds\": [\"...\"],",
+					"  \"verification\": <required iff input.successCriteria; see Self-verification>",
+					"}"
+				].join("\n")
+			})
+		}
+	]);
+}
+//#endregion
 //#region ../agent-runtime/src/prompts/fulfill-brief.ts
 /**
 * Build the first user-message prompt for a `fulfill_brief` task.
@@ -11016,7 +11069,11 @@ function buildFulfillBriefUserPrompt(input, ctx) {
 		"5. For every commit, create a signed diary entry first via",
 		"   `moltnet_create_entry` and embed its id in the commit trailer",
 		"   `MoltNet-Diary: <id>` (per the runtime instructor).",
-		"6. Push the branch and open a PR."
+		"6. Push the branch and open a PR — run `git push` and `gh pr create`",
+		"   IN the VM with your normal `bash` tool (use the",
+		"   `GH_TOKEN=$(moltnet github token …) gh …` form from the runtime",
+		"   instructor). Do NOT use `moltnet_host_exec` for this; it needs human",
+		"   approval that is unavailable in a headless run."
 	].join("\n");
 	return assembleTaskPrompt("fulfill_brief", [
 		{
@@ -11716,6 +11773,12 @@ function buildRunEvalUserPrompt(input, ctx) {
 */
 function buildTaskUserPrompt(task, ctx) {
 	switch (task.taskType) {
+		case FREEFORM_TYPE:
+			if (!Value.Check(FreeformInput, task.input)) {
+				const errors = [...Value.Errors(FreeformInput, task.input)];
+				throw new Error(`freeform input failed validation: ${JSON.stringify(errors.slice(0, 3))}`);
+			}
+			return buildFreeformUserPrompt(task.input, { taskId: ctx.taskId });
 		case FULFILL_BRIEF_TYPE:
 			if (!Value.Check(FulfillBriefInput, task.input)) {
 				const errors = [...Value.Errors(FulfillBriefInput, task.input)];
@@ -15453,6 +15516,11 @@ function buildRuntimeInstructor(ctx) {
 		"",
 		"- `git push` uses the gitconfig-configured credential helper and is not",
 		"  a `gh` call — it does not need `GH_TOKEN`.",
+		"- Run `git` and `gh` in the VM with your normal `bash` tool — your",
+		"  credentials are injected here, so they work in the guest. The",
+		"  `moltnet_host_exec` tool is a last-resort host escape-hatch that",
+		"  requires human approval and is unavailable in headless task runs;",
+		"  never use it for routine git/gh.",
 		"",
 		"## Diary discipline",
 		"",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@themoltnet/pi-extension",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "type": "module",
   "description": "MoltNet pi extension — sandboxed tool execution in Gondolin VMs with MoltNet identity and persistent memory",
   "license": "MIT",
@@ -31,8 +31,8 @@
     "@earendil-works/gondolin": "^0.9.1",
     "@opentelemetry/api": "^1.9.0",
     "@sinclair/typebox": "^0.34.0",
-    "@themoltnet/sdk": "0.106.0",
-    "@themoltnet/agent-runtime": "0.19.0"
+    "@themoltnet/agent-runtime": "0.19.1",
+    "@themoltnet/sdk": "0.106.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.74.0",