Devon

Instructions

Implementation Reference

• src/tools/records/duplicate-record.ts:29-56 (handler)

  The 'run' function handles the logic for duplicating a DEVONthink record by constructing and executing a JXA script.

  run: async (args, executor) => {
    const { uuid, recordId, recordPath, destinationGroupUuid, databaseName } = args;
  
    const script = `
      ${JXA_APP}
      var uuid = ${jxaLiteral(uuid ?? null)};
      var recordId = ${jxaLiteral(recordId ?? null)};
      var recordPath = ${jxaLiteral(recordPath ?? null)};
      var recordName = null;
      var dbName = ${jxaLiteral(databaseName ?? null)};
      var destinationGroupUuid = ${jxaLiteral(destinationGroupUuid)};
  
      ${JXA_RESOLVE_DB}
      ${JXA_RESOLVE_RECORD}
  
      var destGroup = app.getRecordWithUuid(destinationGroupUuid);
      if (!destGroup || !destGroup.uuid()) throw new Error("Destination group not found for UUID: " + destinationGroupUuid);
  
      var duplicate = app.duplicate({record: record, to: destGroup});
      if (!duplicate || !duplicate.uuid()) throw new Error("Duplicate operation failed");
  
      var record = duplicate;
      JSON.stringify(${JXA_RECORD_PROPS});
    `;
  
    const result = executor.run(script);
    return JSON.parse(result.stdout);
  },

• src/tools/records/duplicate-record.ts:22-28 (schema)

  The Zod schema defines the input parameters for the 'duplicate_record' tool.

  schema: z.object({
    uuid: z.string().optional().describe("UUID of the record to duplicate"),
    recordId: z.number().int().nonnegative().optional().describe("Numeric record ID (requires databaseName)"),
    recordPath: z.string().optional().describe("Record path within the database (requires databaseName)"),
    destinationGroupUuid: z.string().describe("UUID of the destination group for the duplicate"),
    databaseName: z.string().optional().describe("Database name (required for recordId or recordPath lookups)"),
  }),

• src/tools/records/duplicate-record.ts:14-57 (registration)

  The tool is defined and exported as 'duplicateRecordTool' using the 'defineTool' helper.

  export const duplicateRecordTool = defineTool({
    name: "duplicate_record",
    description:
      "Duplicate a record to any destination group, creating an independent copy. " +
      "Unlike replicants, duplicates are completely separate records — editing one does not affect the other. " +
      "The duplicate can be placed in a different database from the original. " +
      "Destination group UUID is required. " +
      "Returns the properties of the newly created duplicate.",
    schema: z.object({
      uuid: z.string().optional().describe("UUID of the record to duplicate"),
      recordId: z.number().int().nonnegative().optional().describe("Numeric record ID (requires databaseName)"),
      recordPath: z.string().optional().describe("Record path within the database (requires databaseName)"),
      destinationGroupUuid: z.string().describe("UUID of the destination group for the duplicate"),
      databaseName: z.string().optional().describe("Database name (required for recordId or recordPath lookups)"),
    }),
    run: async (args, executor) => {
      const { uuid, recordId, recordPath, destinationGroupUuid, databaseName } = args;
  
      const script = `
        ${JXA_APP}
        var uuid = ${jxaLiteral(uuid ?? null)};
        var recordId = ${jxaLiteral(recordId ?? null)};
        var recordPath = ${jxaLiteral(recordPath ?? null)};
        var recordName = null;
        var dbName = ${jxaLiteral(databaseName ?? null)};
        var destinationGroupUuid = ${jxaLiteral(destinationGroupUuid)};
  
        ${JXA_RESOLVE_DB}
        ${JXA_RESOLVE_RECORD}
  
        var destGroup = app.getRecordWithUuid(destinationGroupUuid);
        if (!destGroup || !destGroup.uuid()) throw new Error("Destination group not found for UUID: " + destinationGroupUuid);
  
        var duplicate = app.duplicate({record: record, to: destGroup});
        if (!duplicate || !duplicate.uuid()) throw new Error("Duplicate operation failed");
  
        var record = duplicate;
        JSON.stringify(${JXA_RECORD_PROPS});
      `;
  
      const result = executor.run(script);
      return JSON.parse(result.stdout);
    },
  });